---
title: "Register an agent for a read-scoped token"
method: POST
path: "/agent/auth/register"
tags: ["account"]
---

# Register an agent for a read-scoped token

`POST /agent/auth/register`

## Request

- Base URL: `https://aicontentdrop.com`
- URL: `https://aicontentdrop.com/agent/auth/register`
- Auth: none required

Self-registration for unattended agents (WorkOS auth.md `agent_auth`, identity type `anonymous`). Returns a client_id/client_secret and an immediately usable read-scoped bearer token. The token only raises rate limits on the public read surface — it cannot generate, spend credits, or read an account. Generation needs an `acd_live_` key created by a signed-in human.

## Request body

- object
  - `client_name` string: How you want to be identified in our logs
  - `identity_type` 'anonymous'

## Response `201`

Registered. The response already contains a usable read-scope bearer token.

- AgentRegistration: 201 from POST /agent/auth/register. One unauthenticated call returns a usable read-scope bearer token — no email, no human, no approval.
  - `client_id` string, required
  - `client_secret` string: Shown once. Needed only to claim the client against a real account later.
  - `client_name` string
  - `identity_type` 'anonymous'
  - `access_token` string, required: Send as `Authorization: Bearer <token>`.
  - `token_type` 'Bearer', required
  - `expires_in` integer, required: Seconds until expiry (86400).
  - `expires_at` integer: Unix seconds.
  - `scope` 'read', required: Read only. This token cannot spend credits.
  - `claim_uri` string, uri
  - `revocation_uri` string, uri
  - `documentation` string, uri
  - `note` string

## Other responses

- `400`: Unsupported identity_type
- `429`: Rate limited. Read Retry-After (header) or error.retry_after_seconds (body) — they carry the same number — and wait that long. Retrying sooner extends the window rather than shortening it.
- `500`: Unexpected failure on our side. Retry once; nothing was charged.

---

[API](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api.md) · [All operations](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/revisions/75a13a8043ae?raw)