Delete an API key

Deletes a secret key; requests made with it fail from then on.

Only a person signed in to the Voidhash dashboard can do this; a secret key, a CLI key or an MCP client cannot.

Errors

Status	`type`	`code`	When
400	`invalid_request`	`publishable_key_not_editable`	For a publishable key, which apps already ship with.

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

More in API keys

Something wrong or missing on this page? Tell us by email or on Discord.

On this page

Authorization Path parameters Examples Response body Errors More in API keys

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Path parameters

projectId*string

The project's id, proj_.... A secret key works only in the project it belongs to.

apiKeyId*string

The key's id: api_sk_... for a secret key, api_pk_... for a publishable key.

Examples

curl -X DELETE "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/api-keys/api_sk_r6t9y2u5i8o1p4a7s0d3f6g9" \  -H "Authorization: Bearer vh_sk_..."

Empty

{  "error": {    "type": "invalid_request",    "code": "publishable_key_not_editable",    "message": "A publishable key cannot be edited, rotated or deleted: your apps ship with it. Only secret keys can.",    "param": "apiKeyId"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "permission_denied",    "message": "Insufficient permissions."  }}

{  "error": {    "type": "not_found",    "code": "project_not_found",    "message": "There is no project proj_tz4a98xxat96iws9zmbrgj3a, or this credential cannot use it.",    "param": "projectId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Delete an API key

Errors

More in API keys

Delete an API key

Errors

More in API keys

Authorization

Path parameters

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Delete an API key

Delete an API key

204

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`