---
title: "POST /agent-commerce/v1/agents"
method: POST
path: "/agent-commerce/v1/agents"
---

# POST /agent-commerce/v1/agents

`POST /agent-commerce/v1/agents`

## Request

- Base URL: `https://mondoir.art`
- URL: `https://mondoir.art/agent-commerce/v1/agents`
- Auth: none required
- TypeScript: <https://skmtc.dev/mondoir/apis/mondoir-api/docs/agent-commerce/v1/agents/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `name` string, required

## Response `201`

Store access_token privately. No human signup or approval ceremony.

- object
  - `agent_id` string, required
  - `access_token` string, required
  - `token_type` 'Bearer', required
  - `expires_in` unknown, required
  - `mode` 'testnet' | 'live', required

## Other responses

- `400`: Invalid input or browser cookies supplied.
- `401`: Missing, expired or revoked bearer credential.
- `404`: Resource not found or checkout disabled.
- `409`: Item unavailable, selection changed or quote conflict.
- `429`: Rate limited; honor Retry-After.
- `503`: Temporarily unavailable. Never assume payment failed or repay.

## Changes

- **2026-10-18** `4990dc8b3ef4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mondoir/apis/mondoir-api/changes/agent-commerce/v1/agents/post.md)

---

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