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

# Read one Model API collaborator's role

> Return id, role, and isOrganization for one assigned user or organization.
Match is by id only (user or organization). Everyone / visibility is not returned.
You need permission to view the Model API.

Related:
- GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators (list all)
- PUT /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId} (change role)
- DELETE /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId} (remove)




## OpenAPI

````yaml /api-specs/cloud/public-api.json get /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId}
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 6.4.0
  x-catalog-key: nucleus
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security: []
tags:
  - name: Projects
  - name: Project templates
  - name: Workspaces
  - name: Jobs
  - name: HPC Jobs
  - name: Environments
  - name: Hardware Tiers
  - name: Datasets
  - name: Data Sources
  - name: GenAI
  - name: AI Systems
  - name: Apps
  - name: App versions
  - name: App instances
  - name: Model APIs
  - name: Registered models
  - name: Model deployment
  - name: Extensions
  - name: Cost and billing
  - name: Users and organizations
  - name: Service accounts
  - name: Personal Access Tokens
  - name: Personal Access Tokens (admin)
  - name: Audit Trail
  - name: Custom metrics
  - name: PPM
  - name: Model Monitoring models
  - name: Model Monitoring drift and quality
  - name: Model Monitoring settings
  - name: Model Monitoring authentication
  - name: Governance bundles
  - name: Governance policies
  - name: Governance evidence and results
  - name: Governance operations
  - name: NetApp Volumes
  - name: NetApp Volumes snapshots
  - name: NetApp Volumes filesystems
  - name: NetApp Volumes transfers
  - name: Tags
  - name: Properties
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId}:
    get:
      tags:
        - Model APIs
      summary: Read one Model API collaborator's role
      description: >
        Return id, role, and isOrganization for one assigned user or
        organization.

        Match is by id only (user or organization). Everyone / visibility is not
        returned.

        You need permission to view the Model API.


        Related:

        - GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators (list
        all)

        - PUT
        /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId}
        (change role)

        - DELETE
        /api/modelServing/beta/modelApis/{modelApiId}/collaborators/{collaboratorId}
        (remove)
      operationId: getModelApiCollaborator
      parameters:
        - description: >
            Model API id (24-character hex). Obtain from GET
            /api/modelServing/v1/modelApis

            or the Model API details URL.
          in: path
          name: modelApiId
          required: true
          schema:
            type: string
        - description: |
            Domino user or organization id (24-character hex). Copy `id` from
            GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators.
          in: path
          name: collaboratorId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelApiCollaborator'
          description: The Model API collaborator with the given id.
        '400':
          description: >
            modelApiId or collaboratorId is not a 24-character hex id. Use ids
            from

            GET /api/modelServing/v1/modelApis and

            GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators.
        '401':
          description: >-
            Authentication required. Provide a valid Domino session or API
            token.
        '403':
          description: >
            You cannot view this Model API. Ask an Owner to grant at least
            Viewer, or retry

            with an account that already has access.
        '404':
          description: >
            No Model API exists for modelApiId, or no Owner/Editor/Viewer
            collaborator has

            this id. List with GET
            /api/modelServing/beta/modelApis/{modelApiId}/collaborators

            and retry with a returned id.
      security:
        - DominoApiKey: []
        - BearerAuthentication: []
components:
  schemas:
    ModelApiCollaborator:
      properties:
        id:
          description: Domino user or organization id.
          nullable: false
          type: string
        isOrganization:
          description: Whether id identifies an organization.
          nullable: false
          type: boolean
        role:
          description: Collaborator role. Management APIs accept Owner, Editor, and Viewer.
          nullable: false
          type: string
      required:
        - id
        - role
        - isOrganization
  securitySchemes:
    DominoApiKey:
      type: apiKey
      in: header
      name: X-Domino-Api-Key
    BearerAuthentication:
      type: apiKey
      name: Authorization
      in: header

````

## Related topics

- [Change a Model API collaborator's role](/api-reference/model-apis/change-a-model-api-collaborators-role.md)
- [See who can access a Model API](/api-reference/model-apis/see-who-can-access-a-model-api.md)
- [Update collaborator role](/api-reference/model-monitoring-models/put-model-monitorv2apimodel-collaborators.md)
- [Read who can discover and invoke a Model API](/api-reference/model-apis/read-who-can-discover-and-invoke-a-model-api.md)