Create an approved agent's inbox

POST

https://api.agentmailer.ai/v1/agent/bootstrap

POST

/v1/agent/bootstrap

$ curl -X POST https://api.agentmailer.ai/v1/agent/bootstrap \
>      -H "Idempotency-Key: Idempotency-Key" \
>      -H "Authorization: Bearer <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "agent": {
3     "id": "string",
4     "trustTier": "bootstrap"
5   },
6   "identity": {
7     "id": "string",
8     "handle": "string",
9     "emailAddress": "string"
10   },
11   "organization": {
12     "id": "string"
13   },
14   "pod": {
15     "id": "string",
16     "name": "string"
17   },
18   "inbox": {
19     "id": "string",
20     "address": "string",
21     "status": "string"
22   },
23   "capabilities": {
24     "receive": true,
25     "send": true,
26     "imap": true,
27     "smtp": true,
28     "customDomains": true,
29     "a2a": true
30   },
31   "limits": {
32     "messagesPerDay": 1,
33     "recipientsPerMessage": 1,
34     "attachmentBytes": 1
35   },
36   "links": {
37     "inbox": "string",
38     "messages": "string",
39     "events": "string",
40     "imap": "string",
41     "smtp": "string",
42     "a2a": "string",
43     "agentCard": "string"
44   }
45 }

Create an approved agent's inbox

Authentication

AuthorizationBearer

Human-approved credential. Least-privilege grants are published in RFC 9728 protected-resource metadata and on each operation as x-required-permission.

Request

This endpoint expects an object.

requestedLocalPartstringOptionalformat: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"3-48 characters

podNamestringOptional1-64 characters

Response

Existing bootstrap replayed

agentobject

identityobject

organizationobject

podobject

inboxobject

capabilitiesobject

limitsobject

linksobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

Authentication

Headers

Request

Response

Errors