dev.cocore.account.deleteApiKey

cocore.dev

Documentation

Hard-delete one of the authenticated account's API keys, removing the row entirely (no audit trail recovery afterwards). For most flows revokeApiKey is preferable; use this to clean up revoked or expired keys you no longer want listed. Scoped to the caller's DID. Idempotent: deleting an unknown key returns `deleted: false`.

main procedure

Hard-delete one of the authenticated account's API keys, removing the row entirely (no audit trail recovery afterwards). For most flows revokeApiKey is preferable; use this to clean up revoked or expired keys you no longer want listed. Scoped to the caller's DID. Idempotent: deleting an unknown key returns `deleted: false`.

Input

Encodingapplication/json
id string Required

The `id` of the key to delete (from createApiKey or listApiKeys).

maxLength: 200 bytesminLength: 1 bytes

Output

Encodingapplication/json
deleted boolean Required

True if a key owned by the caller was deleted by this call; false if no matching key existed.

Errors

AuthRequired No valid session cookie or bearer key was presented.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "The `id` of the key to delete (from createApiKey or listApiKeys)."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthRequired",
      "description": "No valid session cookie or bearer key was presented."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "deleted"
      ],
      "properties": {
        "deleted": {
          "type": "boolean",
          "description": "True if a key owned by the caller was deleted by this call; false if no matching key existed."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Hard-delete one of the authenticated account's API keys, removing the row entirely (no audit trail recovery afterwards). For most flows revokeApiKey is preferable; use this to clean up revoked or expired keys you no longer want listed. Scoped to the caller's DID. Idempotent: deleting an unknown key returns `deleted: false`."
}

Lexicon Garden

@