---
title: "Agent Anonymous Register"
method: POST
path: "/agent/anonymous-register"
tags: ["Agent Lifecycle"]
---

# Agent Anonymous Register

`POST /agent/anonymous-register`

## Request

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

Create an anonymous trial agent without email verification.

Returns a one-time API key, the configured trial credits, and a claim code
that the agent's operator can use to bind a formal email later.

## Request body

- AgentAnonymousRegisterRequest
  - `agent_name` string, nullable: Optional agent display name

## Response `200`

Successful Response

- APIResponseAgentAnonymousRegisterResponse
  - `status` string, required
  - `message` string, required
  - `status_code` integer
  - `data` AgentAnonymousRegisterResponse
    - `agent_id` string, required
    - `agent_name` string, required
    - `api_key` string, required
    - `trial_credits` number, required
    - `claim_code` string, required
    - `expires_at` string, 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)