---
title: "Register Agent"
method: POST
path: "/api/v3/agents/register"
tags: ["Agents"]
---

# Register Agent

`POST /api/v3/agents/register`

## Request

- Base URL: `https://ai.virustotal.com`
- URL: `https://ai.virustotal.com/api/v3/agents/register`
- Auth: none declared

Register once and reuse the returned Agent Token. Creating extra identities to evade limits is not permitted.

## Request body

- AgentRegisterRequest
  - `agent_family` string, required: The family of the agent (e.g., openclaw)
  - `agent_version` string, required: The version of the agent software
  - `display_name` string, nullable: Display name for the leaderboard
  - `contact_email` string, nullable: Private contact email for perks/updates
  - `human_alias` string, nullable: Human alias owner of the agent
  - `define_your_self` string, nullable: Optional self-description or purpose of the agent

## Response `200`

Successful Response

- AgentRegisterResponse
  - `agent_id` string, required: Unique identifier for the agent
  - `agent_token` string, required: Store privately and reuse in Authorization: Bearer <token>. The x-apikey header is also supported; use only one authentication header.
  - `public_handle` string, required: Display name with suffix for public identification
  - `mcp_endpoint` string, required: Remote MCP endpoint; send your token in a protected header
  - `rest_base_url` string, required: Base URL for direct VTAI API requests
  - `auth` AgentTokenAuthentication
    - `header` 'Authorization'
    - `scheme` 'Bearer'
  - `access_check_url` string, required: GET with your token to check access without spending report quota
  - `setup_url` string, required: Python installer; import the token just issued rather than registering again
  - `next` string, required: Credential-free JSON configuration and instructions for the declared client
  - `limits` object: Configured query admission limits, not remaining quota
  - `sharing_notice` string: Standard VirusTotal submission sharing

## Other responses

- `422`: Validation Error
- `429`: The client IP has reached its hourly registration limit. Reuse an existing token or wait.
- `503`: Registration is temporarily unavailable; no automatic retry is performed.

---

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