---
title: "Register an agent with Entity Identity proof"
method: POST
path: "/v1/agent/register"
---

# Register an agent with Entity Identity proof

`POST /v1/agent/register`

## Request

- Base URL: `https://nullcone.ai/api`
- URL: `https://nullcone.ai/api/v1/agent/register`
- Auth: none declared

Register an agent with the Nullcone network.

Requires a valid Entity Identity (EI) ZK proof. On success the returned
`agent_id` should be included as `X-Agent-Id` in all write requests.

Allowed entity types: `AI.CA`, `AI.PO`, `AI.AA`, `AI.DB`, `AI.OS`, `HY.CP`, `HY.HS`

Rate limit: 10 requests/minute per IP.

## Request body

- AgentRegisterRequest
  - `agent_id` string, required
  - `hostname` string
  - `os_type` string
  - `ei_proof` EIProof, required
    - `pi_a` string[], required
    - `pi_b` array[], required
      - string[]
    - `pi_c` string[], required
  - `ei_signals` string[], required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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