# Add permissions to a role.

Endpoint: POST /roles/{roleId}/permissions
Version: 3.30.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `roleId` (string, required)
    The ID of the role.

## Request body:

  - `application/json` (unknown)
    Permissions to add to the role.

## Request fields (application/json):

  - `permission_objects` (array, required)
    Array of permissions with object type and their permission.

  - `permission_objects.object_type` (string, required)
    Object type.
    Enum: "ALGORITHM", "ACCESS_GROUP", "ACCOUNT", "AUDIT_LOGS_SUMMARY_REPORT", "ROLE", "API_USAGE_REPORT", "BOOKMARK", "CDB", "CLASSIFIER", "DATA_CLASS", "DATABASE_TEMPLATE", "DISCOVERY_EXPRESSION", "DISCOVERY_POLICY", "DSOURCE", "ENGINE", "ENVIRONMENT", "COMPLIANCE_JOB_COLLECTION", "MASKING_JOB", "MASKING_ENVIRONMENT", "MASKING_FILE_UPLOAD", "MASKING_JOB_SET", "REPORT_SCHEDULE", "RULE_SET", "SOURCE", "VAULT", "VCDB", "VDB", "VDB_GROUP", "CONNECTOR", "CONNECTIVITY_CHECK", "DSOURCE_USAGE_REPORT", "DSOURCE_CONSUMPTION_REPORT", "JOB", "DCT_PRODUCT_TELEMETRY_BUNDLE", "PRODUCT_INFO", "PRODUCT_REGISTRATION", "PROXY_CONFIGURATION", "SMTP_CONFIG", "MASKING_EXECUTION_METRICS_REPORT", "STORAGE_SUMMARY_REPORT", "STORAGE_SAVINGS_SUMMARY_REPORT", "VDB_INVENTORY_REPORT", "LDAP", "SAML", "PASSWORD_POLICY", "GLOBAL_PROPERTIES", "SYSTEM", "API_CLASSIFICATION", "VIRTUALIZATION_POLICY", "DATASET_GROUP", "METADATA_DATABASE", "ENGINE_VAULT", "KERBEROS_CONFIG", "TIMEFLOW", "HYPERSCALE_INSTANCE", "HYPERSCALE_CONNECTOR", "HYPERSCALE_DATASET", "TOOLKIT", "MASKING_PLUGIN", "REPLICATION_PROFILE", "NAMESPACE", "ENGINE_PERFORMANCE_ANALYTIC_REPORT", "STAGING_SOURCE", "DATA_RISK_REPORT", "ENGINE_GLOBAL_OBJECT_STATE_REPORT", "DATA_LAYOUT", "VIRTUALIZATION_JOB", "GLOBAL_TAG", "VIRTUALIZATION_ACTION", "VIRTUALIZATION_ALERT", "VIRTUALIZATION_FAULT", "LICENSE", "VIRTUALIZATION_POLICY_TARGET", "UPGRADE_MIGRATE_JOB", "DATA_CONNECTION", "HOOK_TEMPLATE", "JOB_ORCHESTRATOR", "AI_SERVICE", "STAGING_CDB", "LICENSE_USAGE_SUMMARY_REPORT", "SYNTHETIC_APPLICATION", "SYNTHETIC_DATASET", "SYNTHETIC_CONNECTOR", "SYNTHETIC_GENERATOR_FRAMEWORK", "SYNTHETIC_JOB", "SYNTHETIC_FILE", "SYNTHETIC_EXECUTION", "SYNTHETIC_EXECUTION_COMPONENT", "SYNTHETIC_SEED_LIST_FILE", "SYNTHETIC_GENERATOR_INSTANCE", "PAAS_PLUGIN", "CLOUD_ACCOUNT", "PAAS_DATABASE", "CDB_DSOURCE", "PAAS_INSTANCE", "SYNTHETIC_JDBC_DRIVER", "MOUNT_INFORMATION", "RECORD_TYPE", "LLM_PROVIDER", "COMPLIANCE_JDBC_DRIVER", "SSH_KEY", "UPGRADE_IMAGE", "UPGRADE_OPERATION", "COMPLIANCE_PASSWORD_VAULT", "COMPLIANCE_CREDENTIAL_PATH", "FILE_FORMAT", "MAINFRAME_DATASET_FORMAT", "FILE_FIELD", "FEATURE_ASSIGNMENT", "STANDALONE_SERVICE", "SYNTHETIC_JDBC_PARAMETER_EXEMPTION"

  - `permission_objects.permissions` (array, required)
    List of permissions.

## Response 200:

  - `200` (unknown)
    The updated role.

## Response 200 fields (application/json):

  - `name` (string, required)
    The Role name.

  - `description` (string)
    Role description.

  - `permission_objects` (array, required)
    The list of permissions granted by this role.

  - `permission_objects.object_type` (string, required)
    Object type.
    Enum: "ALGORITHM", "ACCESS_GROUP", "ACCOUNT", "AUDIT_LOGS_SUMMARY_REPORT", "ROLE", "API_USAGE_REPORT", "BOOKMARK", "CDB", "CLASSIFIER", "DATA_CLASS", "DATABASE_TEMPLATE", "DISCOVERY_EXPRESSION", "DISCOVERY_POLICY", "DSOURCE", "ENGINE", "ENVIRONMENT", "COMPLIANCE_JOB_COLLECTION", "MASKING_JOB", "MASKING_ENVIRONMENT", "MASKING_FILE_UPLOAD", "MASKING_JOB_SET", "REPORT_SCHEDULE", "RULE_SET", "SOURCE", "VAULT", "VCDB", "VDB", "VDB_GROUP", "CONNECTOR", "CONNECTIVITY_CHECK", "DSOURCE_USAGE_REPORT", "DSOURCE_CONSUMPTION_REPORT", "JOB", "DCT_PRODUCT_TELEMETRY_BUNDLE", "PRODUCT_INFO", "PRODUCT_REGISTRATION", "PROXY_CONFIGURATION", "SMTP_CONFIG", "MASKING_EXECUTION_METRICS_REPORT", "STORAGE_SUMMARY_REPORT", "STORAGE_SAVINGS_SUMMARY_REPORT", "VDB_INVENTORY_REPORT", "LDAP", "SAML", "PASSWORD_POLICY", "GLOBAL_PROPERTIES", "SYSTEM", "API_CLASSIFICATION", "VIRTUALIZATION_POLICY", "DATASET_GROUP", "METADATA_DATABASE", "ENGINE_VAULT", "KERBEROS_CONFIG", "TIMEFLOW", "HYPERSCALE_INSTANCE", "HYPERSCALE_CONNECTOR", "HYPERSCALE_DATASET", "TOOLKIT", "MASKING_PLUGIN", "REPLICATION_PROFILE", "NAMESPACE", "ENGINE_PERFORMANCE_ANALYTIC_REPORT", "STAGING_SOURCE", "DATA_RISK_REPORT", "ENGINE_GLOBAL_OBJECT_STATE_REPORT", "DATA_LAYOUT", "VIRTUALIZATION_JOB", "GLOBAL_TAG", "VIRTUALIZATION_ACTION", "VIRTUALIZATION_ALERT", "VIRTUALIZATION_FAULT", "LICENSE", "VIRTUALIZATION_POLICY_TARGET", "UPGRADE_MIGRATE_JOB", "DATA_CONNECTION", "HOOK_TEMPLATE", "JOB_ORCHESTRATOR", "AI_SERVICE", "STAGING_CDB", "LICENSE_USAGE_SUMMARY_REPORT", "SYNTHETIC_APPLICATION", "SYNTHETIC_DATASET", "SYNTHETIC_CONNECTOR", "SYNTHETIC_GENERATOR_FRAMEWORK", "SYNTHETIC_JOB", "SYNTHETIC_FILE", "SYNTHETIC_EXECUTION", "SYNTHETIC_EXECUTION_COMPONENT", "SYNTHETIC_SEED_LIST_FILE", "SYNTHETIC_GENERATOR_INSTANCE", "PAAS_PLUGIN", "CLOUD_ACCOUNT", "PAAS_DATABASE", "CDB_DSOURCE", "PAAS_INSTANCE", "SYNTHETIC_JDBC_DRIVER", "MOUNT_INFORMATION", "RECORD_TYPE", "LLM_PROVIDER", "COMPLIANCE_JDBC_DRIVER", "SSH_KEY", "UPGRADE_IMAGE", "UPGRADE_OPERATION", "COMPLIANCE_PASSWORD_VAULT", "COMPLIANCE_CREDENTIAL_PATH", "FILE_FORMAT", "MAINFRAME_DATASET_FORMAT", "FILE_FIELD", "FEATURE_ASSIGNMENT", "STANDALONE_SERVICE", "SYNTHETIC_JDBC_PARAMETER_EXEMPTION"

  - `permission_objects.permissions` (array, required)
    List of permissions.

  - `immutable` (boolean)
    If set to true, adding or removing permission is not allowed.

  - `tags` (array)

  - `tags.key` (string, required)
    Key of the tag
    Example: key-1

  - `tags.value` (string, required)
    Value of the tag
    Example: value-1

  - `ui_profiles` (array)
    The list of profiles that influence the navigation menus shown in the UI.

  - `id` (string)
    The Role ID.

  - `system_role` (boolean)
    System role are pre defined roles. System roles cannot be modified.