Skip to main content
POST
Revoke a hosted agent (ALPHA)

Authorizations

x-api-key
string
header
required

Path Parameters

payment_agent_id
string
required

Response

Agent revoked

id
string
name
string
customer_id
string
hosted
boolean
signer_id
string
signer_public_key
string

base64 P-256 SPKI

wallet_ids
string[]

DERIVED - wallets whose attached signer groups contain the agent's signer. Empty until the customer's endorsed attaches land.

state
enum<string>

pending is DERIVED - a non-revoked agent recognized on no wallet. It cannot accept instructions until a wallet attach is endorsed.

Available options:
pending,
active,
revoked
signer_group_cleanup
object[]

Present on revoke: the signer groups the (now-revoked) agent's signer still belongs to. A revoked signer can't sign, but its group membership lingers — remove signer_id from each (DELETE /signer-groups/{signer_group_id}/signers/{signer_id}) to finish de-provisioning. Absent when there is nothing to clean up.