Skip to main content
DELETE
/
secrets
/
{id}
Delete secret
curl --request DELETE \
  --url https://api.akua.dev/v1/secrets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'if-match: <if-match>'
{
  "errors": [
    {
      "code": 7002,
      "message": "Resource not found",
      "path": [
        "body",
        "name"
      ],
      "metadata": {}
    }
  ],
  "result": {}
}

Documentation Index

Fetch the complete documentation index at: https://akua-1dce587a.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

​
akua-context
string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.

Required string length: 1 - 53
Example:

"ws_j572abc123def456"

​
if-match
string
required

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256
Example:

"42"

Path Parameters

​
id
string
required

Secret ID. Prefixed form sec_<id> is canonical.

Required string length: 1 - 54
Example:

"sec_j572abc123def456"

Query Parameters

​
force
boolean | null
default:false

Response

Secret deleted