> ## Documentation Index
> Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an internal user

> Retrieves a single internal user (portal team member) by ID.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/internal-users/{id}
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/internal-users/{id}:
    get:
      tags:
        - Internal Users
      summary: Get an internal user
      description: Retrieves a single internal user (portal team member) by ID.
      operationId: retrieve-internal-user
      parameters:
        - description: ID of the internal user to retrieve
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.InternalUserItem'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: No internal user found with the given ID
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    api.InternalUserItem:
      properties:
        avatarImageUrl:
          description: >-
            AvatarImageUrl is the URL of the internal user's avatar image.
            Read-only.
          example: https://portal.example.com/avatars/jordan.png
          format: uri
          type: string
        companyAccessList:
          description: >-
            CompanyAccessList is the set of company IDs the internal user can
            access when

            isClientAccessLimited is true. Empty when the user has access to all
            companies.
          example:
            - 550e8400-e29b-41d4-a716-446655440000
          items:
            type: string
          nullable: true
          type: array
        createdAt:
          description: Created is the RFC 3339 timestamp at which the object was created.
          example: '2024-01-15T09:30:00Z'
          format: date-time
          type: string
        deleted:
          description: >-
            Deleted is true when the object has been deleted; present only on
            delete responses.
          example: true
          type: boolean
        email:
          description: >-
            Email is the internal user's email address, used as the unique login
            identifier within the portal.
          example: jordan.lee@example.com
          format: email
          type: string
        fallbackColor:
          description: >-
            FallbackColor is the hex color (e.g. "#4F46E5") used as the avatar
            background when

            no avatar image is set. The native pattern documents intent; the
            constraint is

            re-applied to the spec by the enrich-openapi post-processing step.
          example: '#4F46E5'
          pattern: ^#[0-9a-fA-F]{6}$
          type: string
        familyName:
          description: FamilyName is the internal user's last (family) name.
          example: Lee
          type: string
        givenName:
          description: GivenName is the internal user's first (given) name.
          example: Jordan
          type: string
        id:
          description: ID is the unique identifier of the object.
          example: 550e8400-e29b-41d4-a716-446655440000
          type: string
        isClientAccessLimited:
          description: >-
            IsClientAccessLimited is true when the internal user can only access
            the companies

            listed in companyAccessList; false (or null) grants access to all
            companies.
          example: true
          nullable: true
          type: boolean
        object:
          allOf:
            - $ref: '#/components/schemas/constants.ApiObject'
          description: Object is the type of the object (e.g. "client", "company").
        role:
          description: Role is the internal user's role within the portal.
          example: admin
          type: string
        updatedAt:
          description: >-
            Updated is the RFC 3339 timestamp at which the object was last
            updated.
          example: '2024-02-20T14:05:00Z'
          format: date-time
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
    constants.ApiObject:
      enum:
        - client
        - internalUser
        - company
        - customField
        - customFieldOption
        - file
        - fileChannel
        - folder
        - messageChannel
        - message
        - notification
      type: string
      x-enum-varnames:
        - ApiObjectClient
        - ApiObjectInternalUser
        - ApiObjectCompany
        - ApiObjectCustomField
        - ApiObjectCustomFieldOption
        - ApiObjectFile
        - ApiObjectFileChannel
        - ApiObjectFolder
        - ApiObjectMessageChannel
        - ApiObjectMessage
        - ApiObjectNotification
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````