Rensei docs
API ReferenceB Y O A

Create a requester registration and mint its bound dispatch key (token returned once).

Create a requester registration and mint its bound dispatch key (token returned once). - Rensei REST API operation reference.

POST
/api/org/{orgId}/requester-registrations

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

orgId*string

Organization id (must match the authenticated org).

Request Body

application/json
  1. body
actorHandle*string

The '' segment of external::.

Length1 <= length
displayName?string|null
allowedProjectIds?array<string>|null
allowedAgentCards?array<string>|

Agent cards this agent may dispatch: unversioned agent card refs such as agent://system/, agent://org// or agent://project//. Omitted or null = any card visible to an allowed project; an empty array allows no card.

cedarPosture?string
Value in"light""strict"
pinnedPoolId?string|null
publicKey?|

Standard base64 of exactly the raw 32-byte Ed25519 public key (44 characters including the final "="); PEM and SPKI/DER containers are not accepted.

Match^[A-Za-z0-9+/]{43}=$
keyName?string
grantedScopes?array<string>

Scope ceiling for the registration AND the scopes stamped on the minted key. Defaults to ["dispatch:invoke"]. Must be members of the api-key scope catalog.

Response Body

Registration created; the rsk_* key fullKey is returned exactly once.

application/json
  1. response
registration*
key*
Example Request
curl -X POST 'https://app.rensei.ai/api/org/string/requester-registrations' \  -H 'Content-Type: application/json' \  -d '{  "actorHandle": "string"}'
Example Response
{  "registration": {    "id": "string",    "orgId": "string",    "actorHandle": "string"  },  "key": {    "id": "string",    "name": "string",    "keyPrefix": "string",    "scopes": [      "string"    ],    "createdAt": "string",    "expiresAt": "string",    "fullKey": "string"  }}

List BYOA requester registrations for the org.

List BYOA requester registrations for the org. - Rensei REST API operation reference.

List hosted routing (placement) decision records for the org.

Newest-first, optionally filtered by sessionId/instanceId/stepId/outcome, keyset-paginated. Each entry is a flat summary; GET the same id under /routing/decisions/{id} for the full stage walk.