Grant an account access

Gives another account access to one environment of a private model you own, production unless the body names another. Every member and API key of that account can then mint tokens for the environment, start sessions on it, and read the model’s public view and schemas. It gets no releases, instances, or writes. The granted account pays for its own sessions. A grant applies at the next request.

Session tokens can open a granted environment when their model scope names it as owner/name:environment. See Limit what a token can do. A model may have at most 100 accounts with access by default.

Callable by an account_admin of the owning account when model serving is enabled for the account. The CLI equivalent is reactor model access grant.

POST

models

{id}

accounts

{account_id}

curl --request POST \
  --url https://api.reactor.inc/models/{id}/accounts/{account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "model": {
    "id": "7b3f1bc2-a4e5-4d78-b9c1-0e6c2f9a1d34",
    "name": "your-org/your-model"
  },
  "account": {
    "id": "3c1d9a7e-2b4f-4c6d-8e0a-1b2c3d4e5f60",
    "slug": "partner-org",
    "name": "Partner Org"
  },
  "environments": [
    {
      "name": "staging",
      "granted_by": "1f2e3d4c-5b6a-4789-90ab-cdef01234567",
      "granted_at": "2026-11-10T09:00:00Z"
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Path Parameters

string<uuid>

required

The model's ID (not its project ID). Find it with GET /models?name=your-org/your-model.

account_id

string<uuid>

required

The account's ID. Use the account_id from GET /me.

Body

application/json

environment

string

The name or ID of an environment of the model. Defaults to production.

Response

The account now has access.

model

object

required

Show child attributes

account

object

required

Show child attributes

environments

object[]

required

Show child attributes

⌘I

curl --request POST \
  --url https://api.reactor.inc/models/{id}/accounts/{account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "model": {
    "id": "7b3f1bc2-a4e5-4d78-b9c1-0e6c2f9a1d34",
    "name": "your-org/your-model"
  },
  "account": {
    "id": "3c1d9a7e-2b4f-4c6d-8e0a-1b2c3d4e5f60",
    "slug": "partner-org",
    "name": "Partner Org"
  },
  "environments": [
    {
      "name": "staging",
      "granted_by": "1f2e3d4c-5b6a-4789-90ab-cdef01234567",
      "granted_at": "2026-11-10T09:00:00Z"
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Grant an account access

Authorizations

Path Parameters

Body

Response