Agents

GET /api/v1/oris/agents/{agent_id}

Get agent profile

Retrieve full agent profile including KYA status and authority scope.

Auth: Ed25519 request signing. Send Authorization, X-Request-Signature, X-Timestamp, and X-Nonce headers on every call. Nonce TTL is thirty seconds.

Path parameters

Name	Type	Required	Description
agent_id	string	Yes

Responses

Status	Description
200	Successful Response
422	Validation Error

Example request

curl -X GET 'https://api.useoris.xyz/api/v1/oris/agents/{agent_id}' \
  -H 'Authorization: oris_sk_live_***' \
  -H 'X-Request-Signature: ***' \
  -H 'X-Timestamp: $(date +%s)' \
  -H 'X-Nonce: $(uuidgen)'

PATCH /api/v1/oris/agents/{agent_id}

Update agent profile

Update mutable fields of an agent profile.

Auth: Ed25519 request signing. Send Authorization, X-Request-Signature, X-Timestamp, and X-Nonce headers on every call. Nonce TTL is thirty seconds.

Path parameters

Name	Type	Required	Description
agent_id	string	Yes

Request body

application/json, schema: AgentUpdateRequest

Responses

Status	Description
200	Successful Response
422	Validation Error

Example request

curl -X PATCH 'https://api.useoris.xyz/api/v1/oris/agents/{agent_id}' \
  -H 'Authorization: oris_sk_live_***' \
  -H 'X-Request-Signature: ***' \
  -H 'X-Timestamp: $(date +%s)' \
  -H 'X-Nonce: $(uuidgen)' \
  -H 'Content-Type: application/json' \
  -d '{...}'

POST /api/v1/oris/agents/{agent_id}/kya

Execute KYA state transition

Transition the agent's KYA status. Developers can suspend or reinstate their agents. Verification (L0->L1) and level upgrades are controlled exclusively by the Oris KYA engine and cannot be triggered manually. Allowed actions: suspend, reinstate, revoke.

Auth: Ed25519 request signing. Send Authorization, X-Request-Signature, X-Timestamp, and X-Nonce headers on every call. Nonce TTL is thirty seconds.

Path parameters

Name	Type	Required	Description
agent_id	string	Yes

Request body

application/json, schema: AgentKyaTransitionRequest

Responses

Status	Description
200	Successful Response
422	Validation Error

Example request

curl -X POST 'https://api.useoris.xyz/api/v1/oris/agents/{agent_id}/kya' \
  -H 'Authorization: oris_sk_live_***' \
  -H 'X-Request-Signature: ***' \
  -H 'X-Timestamp: $(date +%s)' \
  -H 'X-Nonce: $(uuidgen)' \
  -H 'Content-Type: application/json' \
  -d '{...}'

GET /api/v1/oris/agents/{agent_id}/kya-level

Get KYA level status

Returns the agent's current KYA level and promotion eligibility. Level upgrades are controlled exclusively by the Oris KYA engine. Developers cannot upgrade levels manually.

Auth: Ed25519 request signing. Send Authorization, X-Request-Signature, X-Timestamp, and X-Nonce headers on every call. Nonce TTL is thirty seconds.

Path parameters

Name	Type	Required	Description
agent_id	string	Yes

Responses

Status	Description
200	Successful Response
422	Validation Error

Example request

curl -X GET 'https://api.useoris.xyz/api/v1/oris/agents/{agent_id}/kya-level' \
  -H 'Authorization: oris_sk_live_***' \
  -H 'X-Request-Signature: ***' \
  -H 'X-Timestamp: $(date +%s)' \
  -H 'X-Nonce: $(uuidgen)'

POST /api/v1/oris/agents/register

Register a new AI agent

Creates an agent profile under the authenticated developer. The agent starts in PENDING status (KYA Level 0) and cannot transact until verified.

Auth: Ed25519 request signing. Send Authorization, X-Request-Signature, X-Timestamp, and X-Nonce headers on every call. Nonce TTL is thirty seconds.

Request body

application/json, schema: AgentRegisterRequest

Responses

Status	Description
201	Successful Response
422	Validation Error

Example request

curl -X POST 'https://api.useoris.xyz/api/v1/oris/agents/register' \
  -H 'Authorization: oris_sk_live_***' \
  -H 'X-Request-Signature: ***' \
  -H 'X-Timestamp: $(date +%s)' \
  -H 'X-Nonce: $(uuidgen)' \
  -H 'Content-Type: application/json' \
  -d '{...}'