---
title: "Claim a provisioned agent and mint its first session"
method: POST
path: "/claim"
tags: ["auth"]
---

# Claim a provisioned agent and mint its first session

`POST /claim`

## Request

- Base URL: `https://api.catena.com/v1/agent-api`
- URL: `https://api.catena.com/v1/agent-api/claim`
- Auth: HTTP bearer

## Request body

- object
  - `agentId` string, required
  - `clientInstanceId` string, required
  - `clientLabel` string

## Response `200`

Agent claimed; session and refresh tokens minted

- object
  - `agentId` string, required
  - `organizationId` string, required
  - `sessionToken` string, required
  - `refreshToken` string, required
  - `expiresAt` string, date-time, required
  - `apiKey` string, required
  - `name` string, required
  - `activated` boolean, required
  - `policy` object, nullable, required
  - `policyError` string, nullable, required
  - `accounts` object[], required
  - `accountsError` string, nullable, required

## Other responses

- `401`: Operator authentication missing a user id
- `403`: Token not issued to an agent-linking OAuth client, or agent provisioned for a different operator
- `404`: Agent not found
- `409`: Agent already claimed or not in a claimable state

---

[API](https://skmtc.dev/catena/apis/catena-agent-api.md) - [All operations](https://skmtc.dev/catena/apis/catena-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/catena/apis/catena-agent-api/revisions/9b72e32d21f1?raw)