Skip to main content
Permanently revokes a provider, setting its status to "revoked". Revoked providers remain visible in the registry for audit purposes but cannot register new agents or have their agents invoked through the gateway.
Revocation is irreversible. Once a provider is revoked you cannot restore it. All agents published under the provider become uninvocable.

​
Request

curl -X POST http://your-node:8042/v1/providers/acme-labs/revoke \
  -H 'content-type: application/json' \
  -d '{
    "reason": "Provider decommissioned by owner"
  }'

​
Path parameters

​
provider_id
string
required
The identifier of the provider to revoke.

​
Body parameters

​
reason
string
Optional human-readable explanation for the revocation. Stored in the provider record and audit log.

​
Response

Returns the updated ProviderRecord with status set to "revoked".
​
schema_version
integer
Protocol schema version. Currently 1.
​
provider_id
string
The provider identifier.
​
provider_did
string
The DID that was associated with this provider.
​
display_name
string
Human-readable display name, if set.
​
status
string
Always "revoked" after a successful call.
​
registered_at
string
ISO 8601 timestamp of original registration.
​
revoked_at
string
ISO 8601 timestamp of when the provider was revoked.
​
revoke_reason
string
The reason supplied in the request, if any.

​
Status codes

CodeMeaning
200 OKProvider revoked successfully. Returns the updated ProviderRecord.
404 Not FoundNo provider with the given provider_id exists.

​
Example response

{
  "schema_version": 1,
  "provider_id": "acme-labs",
  "provider_did": "did:key:z6MkhaXgBZDvotD1X9gRrYkM5Xq9jYQqK6d8r8bQdE1mV2Xa",
  "display_name": "Acme Labs",
  "status": "revoked",
  "registered_at": "2025-01-15T10:00:00Z",
  "revoked_at": "2025-06-01T08:30:00Z",
  "revoke_reason": "Provider decommissioned by owner"
}