> ## Documentation Index > Fetch the complete documentation index at: https://docs.open.cx/llms.txt > Use this file to discover all available pages before exploring further. # Get an organization user > Inspect an organization user with their teams, permissions, and inherited role status. Use role IDs to distinguish same-name permission sets. The `roles` array includes `is_inherited` for each role. Inherited roles are managed through the main billing organization. Their names can match local roles, so use IDs to match [role definitions](https://docs.open.cx/api-reference/roles/get.md). A member with no roles has no role permissions. ## OpenAPI ````yaml get /users/{user_id} openapi: 3.1.0 info: title: OpenCX API description: > OpenCX is an AI-powered, all-in-one platform for customer support and outbound communications. Use this API to manage your OpenCX organization's AI agents, actions, conversations, contacts, and more. To get started, generate a new API key from the dashboard. ## Authentication All API endpoints require authentication using a Bearer token. You can generate an API key from your OpenCX dashboard. ## Rate Limiting API requests are rate limited to ensure fair usage. The current limits are: - 100 requests per minute for standard endpoints - 1000 requests per minute for streaming endpoints ## Error Handling The API uses standard HTTP status codes and returns detailed error messages in the response body. version: 1.0-beta license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: http://localhost:8080 description: Development - url: https://api.open.cx description: Production security: - bearerAuth: [] paths: /users/{user_id}: get: summary: Get organization user description: >- Retrieve a single organization user and include their current team memberships and availability. operationId: getOrgUser parameters: - schema: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 in: path name: user_id required: true description: Organization user ID responses: '200': description: Default Response content: application/json: schema: $ref: '#/components/schemas/OrgUserDetail' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorDto' components: schemas: OrgUserDetail: $schema: https://json-schema.org/draft/2020-12/schema $id: '#/components/schemas/OrgUserDetail' type: object properties: id: type: number uuid: type: - string - 'null' name: type: string email: type: string format: email pattern: >- ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ avatar_url: anyOf: - type: string format: uri - type: 'null' permissions: anyOf: - type: array items: type: string enum: - '*' - sessions:read - sessions:write - team-sessions:read - team-sessions:write - assigned-sessions:read - assigned-sessions:write - hybrid-inbox:read - phone-outbound-all-numbers:write - sessions-personal-views:write - sessions-shared-views:read - sessions-shared-views:write - sessions-create:write - sessions-sub-sessions:write - merge-sessions:write - sessions-delete-own-messages:write - contacts:read - contacts:write - companies:read - companies:write - sequences:read - sequences:write - ai-training:read - ai-training:write - reports:read - reports:write - help-center:read - help-center:write - help-center-content:read - help-center-content:write - workflows:read - workflows:write - workflows:execute - actions:read - actions:write - mini-apps:read - mini-apps:write - companion:read - companion:write - redaction:read - redaction:write - voc:read - voc:write - audit-logs:read - settings:read - settings:write - settings-general:read - settings-general:write - settings-billing:read - settings-billing:write - settings-api-keys:read - settings-api-keys:write - settings-autopilot:read - settings-autopilot:write - settings-structured-fields:read - settings-structured-fields:write - settings-webhooks:read - settings-webhooks:write - settings-secrets:read - settings-secrets:write - settings-handoff:read - settings-handoff:write - settings-translations:read - settings-translations:write - settings-sso:read - settings-sso:write - settings-security:read - settings-security:write - settings-integrations:read - settings-integrations:write - settings-members:read - settings-members:write - settings-agent-availability:read - settings-agent-availability:write - settings-tags:read - settings-tags:write - settings-sla:read - settings-sla:write - settings-csat:read - settings-csat:write - settings-reports:read - settings-reports:write - settings-office-hours:read - settings-office-hours:write - settings-channels:read - settings-channels:write - settings-channels-voice:read - settings-channels-voice:write - settings-email-fleet:read - settings-email-fleet:write - settings-helpdesk:read - settings-helpdesk:write - settings-custom-statuses:read - settings-custom-statuses:write - settings-availability-statuses:read - settings-availability-statuses:write - settings-personal-profile:read - settings-personal-profile:write - settings-groups:read - settings-groups:write - settings-roles:read - settings-roles:write - settings-scim-role-mappings:read - settings-scim-role-mappings:write - settings-macros:read - settings-macros:write - settings-skills:read - settings-skills:write - type: 'null' roles: type: array items: $ref: '#/components/schemas/OrgUserRole' status: type: string enum: - active - deactivated description: >- deactivated: the user keeps their membership but cannot use the organization until reactivated. Deactivated users have no roles. deactivated_at: anyOf: - type: string format: date-time - type: 'null' description: >- When the user was deactivated in this organization, or null while active. teams: type: array items: type: object properties: group: $ref: '#/components/schemas/GroupDto' is_user_available_on_group: type: boolean required: - group - is_user_available_on_group additionalProperties: false required: - id - name - email - roles - status - deactivated_at - teams additionalProperties: false ErrorDto: type: object properties: statusCode: type: integer message: type: string error: type: string OrgUserRole: $schema: https://json-schema.org/draft/2020-12/schema $id: '#/components/schemas/OrgUserRole' type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: type: string is_inherited: description: >- Whether the role is inherited from the main billing organization. Use role IDs to distinguish roles with the same name. type: boolean required: - id - name additionalProperties: false GroupDto: $schema: https://json-schema.org/draft/2020-12/schema $id: '#/components/schemas/GroupDto' type: object properties: id: type: string organization_id: type: string name: type: string category_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' description: type: - string - 'null' is_support_enabled: type: boolean support_office_hours_id: type: - string - 'null' support_assignment_strategy: type: string enum: - least-busy - round-robin - unassigned call_wrap_up_seconds: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' telephony_pacing_enabled: type: boolean telephony_ring_seconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 telephony_queue_wait_seconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 telephony_distribution: type: string enum: - fewest_answered_today - longest_available phone_sla_policy_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' call_recording_enabled: type: boolean call_languages: type: array items: type: string auto_assign_interval_seconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 zendesk_group_id: type: - string - 'null' zendesk_group_outbound_sync_enabled: type: boolean zendesk_group_channels: anyOf: - type: array items: $ref: '#/components/schemas/SessionChannel' - type: 'null' created_at: anyOf: - type: string format: date-time - type: 'null' updated_at: anyOf: - type: string format: date-time - type: 'null' deleted_at: anyOf: - type: string format: date-time - type: 'null' required: - id - organization_id - name - category_id - description - is_support_enabled - support_office_hours_id - support_assignment_strategy - call_wrap_up_seconds - telephony_pacing_enabled - telephony_ring_seconds - telephony_queue_wait_seconds - telephony_distribution - phone_sla_policy_id - call_recording_enabled - call_languages - auto_assign_interval_seconds - zendesk_group_id - zendesk_group_outbound_sync_enabled - zendesk_group_channels - created_at - updated_at - deleted_at additionalProperties: false SessionChannel: $schema: https://json-schema.org/draft/2020-12/schema $id: '#/components/schemas/SessionChannel' type: string enum: - web - email - phone_voice - slack - sms - whatsapp - instagram - messenger - api - web_voice - twitter - twitter_mentions - app_review - internal securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.