> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Assign User Permission > Assign a direct resource permission to a user. Permissions can be granted at the user level independently of any role assignment. ## OpenAPI ````yaml en/API/Management-API.yaml POST /users/{id}/permissions openapi: 3.1.0 info: title: CData Connect AI Management API version: v1 description: > The Connect AI Management API provides programmatic control over enterprise platform administration. Base path: /api/v1/admin. Use it to manage users, service accounts, roles, and resource permissions without manual UI operations. The API follows OAS 3.0 standards with OAuth 2.0 scoped authentication. On versioning: the version prefix is incremented when breaking changes require it. A new /api/v2/admin path will be introduced with a 6-month deprecation notice before any v1 endpoint is retired. On human users vs. service accounts: human users are provisioned and lifecycle-managed by SCIM; the Management API handles direct overrides and atomic deprovisioning. Service accounts (CI/CD pipelines, IaC tooling, Terraform) are fully managed via the Management API and are not SCIM-owned. servers: - url: https://cloud.cdata.com/api/v1/admin description: Production base URL security: - oauth2: [] tags: - name: Users description: > Lifecycle management for human users: create, update, deprovision, and manage direct role assignments, workspace-scoped roles, and direct resource permissions. SCIM handles group-based provisioning and user creation at scale; this API handles direct overrides and atomic deprovisioning. - name: Service Accounts description: > Full lifecycle management for machine identities (CI/CD pipelines, IaC tooling, Terraform automation). Service accounts are not SCIM-owned and authenticate via OAuth 2.0 client credentials using the `client_id` returned on creation. paths: /users/{id}/permissions: post: tags: - Users summary: Assign User Permission description: > Assign a direct resource permission to a user. Permissions can be granted at the user level independently of any role assignment. operationId: assignUserPermission parameters: - name: id in: path required: true description: User identifier (UUID). schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AssignPermissionRequest' example: resource: salesforce-prod operations: - read type: connection responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/UserPermissionAssignment' example: id: p1b2c3d4-e5f6-7890-abcd-ef1234567890 user_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 resource: salesforce-prod operations: - read type: connection assigned_at: '2026-06-15T10:00:00Z' assigned_by: 00000000-0000-0000-0000-000000000001 '404': $ref: '#/components/responses/UserNotFound' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_operation: summary: Invalid operation value value: error: code: INVALID_OPERATION message: One or more operation values are not valid. invalid_permission_type: summary: Invalid type value value: error: code: INVALID_PERMISSION_TYPE message: Permission type must be connection. security: - oauth2: - management:users:write components: schemas: AssignPermissionRequest: type: object required: - resource - operations - type properties: resource: type: string description: > The name of the specific connection instance this permission applies to. This is the connection name as defined in Connect AI, not the connector type. operations: type: array items: type: string enum: - create - read - update - delete - execute description: One or more operations to permit on the resource. type: type: string enum: - connection description: >- Always `connection`. Classifies what category of resource the permission governs. UserPermissionAssignment: type: object properties: id: type: string format: uuid description: Permission identifier. user_id: type: string format: uuid description: The user this permission is assigned to. resource: type: string description: The connection name this permission applies to. operations: type: array items: type: string enum: - create - read - update - delete - execute description: Allowed operations on the resource. type: type: string enum: - connection description: >- Always `connection`. Classifies what category of resource the permission governs. assigned_at: type: string format: date-time description: ISO 8601 UTC. assigned_by: type: string format: uuid description: The user who assigned this permission. ErrorResponse: type: object properties: error: type: object description: Error details. properties: code: type: string description: SCREAMING_SNAKE_CASE error code. message: type: string description: Human-readable error description. responses: UserNotFound: description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: USER_NOT_FOUND message: The specified user does not exist. securitySchemes: oauth2: type: oauth2 flows: clientCredentials: tokenUrl: https://cloud-login.cdata.com/oauth/token scopes: management:users:read: Read access to user resources. management:users:write: Write access to user resources. management:service-accounts:read: Read access to service account resources. management:service-accounts:write: Write access to service account resources. ````