> ## 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 who can discover and invoke a Model API > Return Public, Discoverable, or Private for this Model API. Use this beta route; GET /api/modelServing/v1/modelApis/{modelApiId} does not include a `visibility` field. Any authenticated user can read visibility when it is Public or Discoverable. Private requires an assigned Owner, Editor, or Viewer. Public: every authenticated Domino user can discover and invoke (JWT or session required; callers are never anonymous). Discoverable: every authenticated user can discover overview metadata; invoke requires an assigned Owner, Editor, or Viewer. Private: assigned collaborators only for discover and invoke. Related: - GET /api/modelServing/v1/modelApis/{modelApiId} (read Model API metadata) - PUT /api/modelServing/beta/modelApis/{modelApiId}/visibility (change visibility) - GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators (list assigned roles) ## OpenAPI ````yaml /api-specs/cloud/public-api.json get /api/modelServing/beta/modelApis/{modelApiId}/visibility 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}/visibility: get: tags: - Model APIs summary: Read who can discover and invoke a Model API description: > Return Public, Discoverable, or Private for this Model API. Use this beta route; GET /api/modelServing/v1/modelApis/{modelApiId} does not include a `visibility` field. Any authenticated user can read visibility when it is Public or Discoverable. Private requires an assigned Owner, Editor, or Viewer. Public: every authenticated Domino user can discover and invoke (JWT or session required; callers are never anonymous). Discoverable: every authenticated user can discover overview metadata; invoke requires an assigned Owner, Editor, or Viewer. Private: assigned collaborators only for discover and invoke. Related: - GET /api/modelServing/v1/modelApis/{modelApiId} (read Model API metadata) - PUT /api/modelServing/beta/modelApis/{modelApiId}/visibility (change visibility) - GET /api/modelServing/beta/modelApis/{modelApiId}/collaborators (list assigned roles) operationId: getModelApiVisibility 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 responses: '200': content: application/json: example: visibility: Discoverable schema: $ref: '#/components/schemas/ModelApiVisibility' description: The current visibility. '400': description: | Invalid modelApiId. Use a 24-character hex Model API id from GET /api/modelServing/v1/modelApis. '401': description: > No Domino session or API token was accepted before the handler ran. Sign in or pass a valid API key. Callers that reach this route without an authenticated principal receive 403 instead. '403': description: > You cannot discover this Model API. That happens when visibility is Private and you are not an assigned Owner, Editor, or Viewer. Ask an Owner to grant at least Viewer, or retry with an account that already has access. Authenticated callers always succeed for Public and Discoverable. '404': description: | No Model API exists for modelApiId. Confirm the id from GET /api/modelServing/v1/modelApis. security: - DominoApiKey: [] - BearerAuthentication: [] components: schemas: ModelApiVisibility: properties: visibility: description: > Public allows all authenticated users to discover and invoke. Discoverable allows all authenticated users to discover, but only assigned collaborators to invoke. Private requires an assigned collaborator role to discover or invoke. enum: - Public - Discoverable - Private nullable: false type: string required: - visibility securitySchemes: DominoApiKey: type: apiKey in: header name: X-Domino-Api-Key BearerAuthentication: type: apiKey name: Authorization in: header ```` ## Related topics - [Change who can discover and invoke a Model API](/api-reference/model-apis/change-who-can-discover-and-invoke-a-model-api.md) - [See who can access a Model API](/api-reference/model-apis/see-who-can-access-a-model-api.md) - [Manage models with model registry](/cloud/platform-capabilities/features/models/register-and-govern/model-registry.md) - [Build and deploy Apps](/cloud/platform-capabilities/features/apps/index.md)