Skip to content
by Unity Nodes
Partner docsapi reference › admin › list the organizations that may use a model admin only

NEAR AI Cloud: List the organizations that may use a model (Admin only)

Updated 13-11-2026

GET /v1/admin/models/{model_name}/access List the organizations that may use 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.

Returns the model's id, name and isListed, and the active organizations that hold a grant for it. The grants restrict the model only while it is unlisted; on a listed model they are kept but have no effect.

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

Admin permissions: admin session, read_write token, or read_only token. Approved read across organizations; does not mutate business state.

Parameters:

  • model_name (path, string, required): Canonical model name (URL-encode if it contains slashes).

Responses: 200: The model and its grants

  • id (string, uuid, required): The model's id.
  • isActive (boolean, required): Grants count only while the model is active.
  • isListed (boolean, required): false: the model is restricted to the organizations below. true: every organization may use it and the grants have no effect.
  • modelName (string, required): The model's canonical name.
  • organizations (array of object, required): The active organizations that hold a grant, oldest grant first.
    • grantedAt (string, date-time, required)
    • grantedByUserEmail (string)
    • grantedByUserId (string, uuid): The admin who made the grant.
    • organizationId (string, uuid, required)
    • organizationName (string, required) 401: Unauthorized 403: Forbidden: not an admin Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 404: Model not found 500: Internal server error