SynapseDocumentation

Revoke credential

Immediately invalidates an agent credential. Any subsequent call using this token is rejected.

POST/api/v1/credentials/agent/:id/revokeWallet JWT

For AI agents

Emergency shutoff: revoke a compromised or over-limit agent token immediately. Takes effect server-side instantly.

Requires: Valid JWT (owner who issued the credential)

Parameters

id

path · required

Credential ID

Generated OpenAPI reference

POST/api/v1/credentials/agent/{id}/revoke

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Credential ID

Response Body

application/json

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/credentials/agent/cred_abc/revoke"
{
  "message": "Credential revoked"
}
{
  "code": "NOT_OWNER",
  "message": "Only the issuing owner can revoke this credential"
}
{
  "code": "CREDENTIAL_NOT_FOUND",
  "message": "No credential with this ID"
}