Revoke a Provider — POST /v1/providers/:provider_id/revoke

Permanently revoke a provider, preventing all future agent invocations. Revoked providers remain visible in the registry for audit purposes.

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

Code	Meaning
200 OK	Provider revoked successfully. Returns the updated ProviderRecord.
404 Not Found	No 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"
}