---
title: "Agent Claim Start"
method: POST
path: "/agent/claim"
tags: ["Agent Lifecycle"]
---

# Agent Claim Start

`POST /agent/claim`

## Request

- Base URL: `https://qveris.ai/api/v1`
- URL: `https://qveris.ai/api/v1/agent/claim`
- Auth: none required

Bind a formal email to an anonymous trial and send a 6-digit code.

## Request body

- AgentClaimStartRequest
  - `claim_code` string, required
  - `email` string, email, required

## Response `200`

Successful Response

- APIResponseUnionAgentClaimStartResponseAgentClaimRiskBlockResponse
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` union
    - AgentClaimStartResponse
      - `email` string, required
    - AgentClaimRiskBlockResponse
      - `reason` 'email_risk_blocked', required
  - `message_key` string, nullable

## Other responses

- `422`: Validation Error
- `429`: Too Many Requests

---

[API](https://skmtc.dev/qveris/apis/qveris-public-rest-api.md) · [All operations](https://skmtc.dev/qveris/apis/qveris-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qveris/apis/qveris-public-rest-api/revisions/7b78aeef092a?raw)