Skip to content
by Unity Nodes
Partner docsapi reference › admin › grant an organization access to a model admin only

NEAR AI Cloud: Grant an organization access to a model (Admin only)

Updated 13-11-2026

PUT /v1/admin/models/{model_name}/access/{org_id} Grant an organization access to a model (Admin only) Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Idempotent: granting again returns the existing grant unchanged. The grant takes effect when the model is unlisted; while the model is listed every organization may use it anyway. It applies at once on the instance that served this request and within 30 seconds on the others.

Note: Model names containing forward slashes must be URL-encoded (e.g. "vendor%2Fmodel").

Admin permissions: admin session or read_write token. A read_only token receives HTTP 403 with error.type insufficient_permissions before the handler runs.

Parameters:

  • model_name (path, string, required): Canonical model name (URL-encode if it contains slashes).
  • org_id (path, string, required): The organization's ID (as a UUID).

Responses: 200: The grant

  • grantedAt (string, date-time, required)
  • grantedByUserEmail (string)
  • grantedByUserId (string, uuid): The admin who made the grant.
  • organizationId (string, uuid, required)
  • organizationName (string, required) 400: Invalid organization ID 401: Unauthorized 403: Forbidden: not an admin, or a read-only admin access token Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 404: Model or organization not found 500: Internal server error