---
title: "Revoke Agent Credential"
method: POST
path: "/agents/{id}/credentials/{cid}/revoke"
tags: ["agents-credentials"]
---

# Revoke Agent Credential

`POST /agents/{id}/credentials/{cid}/revoke`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/agents/{id}/credentials/{cid}/revoke`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Revokes immediately; idempotent. The row stays for audit.

## Path parameters

- `id` string, required
- `cid` string, required

## Request body

- InternalDeliveryHttpHandlerRevokeAgentCredentialRequest
  - `reason` string

## Response `200`

OK

- InternalDeliveryHttpHandlerAgentCredentialResponse
  - `data` EnforcerV3InternalUsecaseAgentsCredentialView
    - `agent_id` string
    - `created_at` string
    - `created_by` string
    - `expires_at` string
    - `id` string
    - `key_prefix` string
    - `last_used_at` string
    - `last_used_ip` string
    - `name` string
    - `revoked_at` string
    - `rotated_from` string
    - `scopes` string[]
  - `success` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)