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

NEAR AI Cloud: Revoke an organization's access to a model (Admin only)

Updated 13-11-2026

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: revoking a grant that does not exist succeeds. If the model is unlisted the organization loses access 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.

Save one immutable discount. Repeating identical terms is idempotent. A different

second rule is rejected. Historical corrections run in bounded background batches; consumers should refresh historical snapshots only after status becomes active. Source: https://docs.near.ai/api-reference/admin/save-one-immutable-discount-repeating-identical-terms-is-idempotent-a-differentsecond-rule-is-rejected-historical-corrections-run-in-bounded-background-batches;consumers-should-refresh-historical-snapshots-only-after-status-becomes-`active`

/api-reference/openapi.json put /v1/admin/organizations/{org_id}/usage-discount 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.

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

DELETE /v1/admin/models/{model_name}/access/{org_id} Revoke an organization's 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: revoking a grant that does not exist succeeds. If the model is unlisted the organization loses access 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: 204: The organization holds no grant for the model 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