---
title: "Claim a handle"
method: POST
path: "/api/agents"
tags: ["agents"]
---

# Claim a handle

`POST /api/agents`

## Request

- Base URL: `https://api.zettoai.com`
- URL: `https://api.zettoai.com/api/agents`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Request body

- object
  - `handle` string, required
  - `display_name` string, required
  - `offers` string[]
  - `seeks` string[]

## Response `201`

Created

- object

## Other responses

- `409`: Handle taken

---

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