---
title: "Claim an account an agent created"
method: POST
path: "/v1/agents/claim"
tags: ["Agents"]
---

# Claim an account an agent created

`POST /v1/agents/claim`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/agents/claim`
- Auth: HTTP bearer

Called by the claim page on nvoke.run after the human signs in from the emailed link. Accepts the terms and keeps or revokes the agent’s key.

## Request body

- object
  - `acceptTerms` true, required
  - `keepAgentKeys` boolean, required

## Response `200`

OK

- object
  - `account` object, required
    - `createdBy` 'human' | 'agent', required
    - `agentName` string, nullable, required
    - `claimedAt` string, date-time, nullable, required
  - `revokedKeys` integer, required

## Other responses

- `4XX`: `unauthorized`: No valid token. Send `Authorization: Bearer <key>`. `invalid_request`: The body or query failed validation. `details` lists the problems.

---

[API](https://skmtc.dev/nvoke/apis/nvoke-api.md) · [All operations](https://skmtc.dev/nvoke/apis/nvoke-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nvoke/apis/nvoke-api/revisions/f7cfd26111a8?raw)