SynapseDocumentation

Issue agent credential

Mint a new spend-limited agent credential. The returned token is used by the agent runtime for all /agent/* calls.

POST/api/v1/credentials/agent/issueWallet JWT

For AI agents

Owner mints a spend-limited token for an autonomous agent. maxCalls and creditLimit prevent runaway spending. Pass the token to the agent — never expose the owner JWT to the agent.

Requires: Valid JWT with consumer_available_balance > 0

Next: Pass token to agent runtime. Agent calls POST /agent/discovery/search then POST /agent/invoke with costUsdc

Generated OpenAPI reference

POST/api/v1/credentials/agent/issue

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

application/json

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/credentials/agent/issue" \  -H "Content-Type: application/json" \  -d '{    "name": "consumer-agent-01",    "maxCalls": 100,    "creditLimit": 5,    "rpm": 60  }'
{
  "credential": {
    "token": "agt_xxx",
    "credential_id": "cred_abc",
    "name": "consumer-agent-01"
  }
}
{
  "code": "INSUFFICIENT_BALANCE",
  "message": "Owner has no spendable balance — deposit USDC first"
}
{
  "code": "LIMIT_EXCEEDED",
  "message": "credit_limit exceeds owner spending policy"
}
Back to API Reference