Skip to main content
POST
Create agent (auto-creates virtual card and policy)

Authorizations

Authorization
string
header
required

API key (sk_sandbox_* / sk_test_* / sk_live_*) or Agent token (at_* / at_dlg_*)

Headers

Idempotency-Key
string

Unique key for idempotent request handling

Body

application/json
name
string
externalId
string
scope
string
usage
enum<string>
Available options:
single,
multi

Response

Agent created with associated card and policy

id
string
ownerId
string
name
string
scope
string | null
externalId
string | null
status
enum<string>
Available options:
active,
frozen,
closed
cardBalanceEuros
number
walletBalanceEuros
number
cardPanMasked
string
policyId
string
cardId
string
createdAt
string<date-time>