---
title: "Optional self-serve catalog credential"
method: POST
path: "/api/agents/register"
tags: ["Onboarding"]
---

# Optional self-serve catalog credential

`POST /api/agents/register`

## Request

- Base URL: `https://vesremont.com`
- URL: `https://vesremont.com/api/agents/register`
- Auth: none required

Optional accountless anonymous registration. Public catalog reads work without it. Returns a short-lived assertion, not an API access token. Exchange once at /oauth/token using the documented JWT bearer grant; catalog:read only. No buyer, signup, manual review or scope upgrade. GET/HEAD on this URL returns the registration descriptor. Compatible address for /oauth/identity; the same validation, rate budgets, assertion and token exchange apply. Optional trailing slash is accepted without a redirect.

## Request body

- object
  - `type` 'anonymous', required: Catalog-only anonymous registration; cannot be claimed as a buyer.

## Response `200`

One-use catalog assertion; never a buyer credential.

- object
  - `registration_id` string, required
  - `registration_type` 'anonymous', required
  - `identity_assertion` string, required: Sensitive one-use assertion. Never log or publish it.
  - `assertion_expires` string, date-time, required
  - `pre_claim_scopes` string[], required
  - `claim_supported` unknown, required

## Other responses

- `400`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `401`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `403`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `405`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `406`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `413`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `415`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `422`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `429`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `503`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.

---

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