---
updatedAt: 2026-05-20T20:59:45.000Z
agentTools:
  projectIndex: https://docs.developers.convert.com/llms.txt
---

# Delete an SDK key

Permanently revokes an SDK key, identified by its `sdk_key` value.
Once deleted, SDKs using this key will no longer be able to fetch configurations or track events for the associated project and environment.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Convert Management API",
    "description": "Move your app forward with the Convert API. The Convert API allows\nyou to manage your Convert Experiences projects using code. The REST API is\nan interface for managing and extending functionality of Convert. For\nexample, instead of creating and maintaining projects using the Convert\nExperiences web dashboard you can create an experiment programmatically.\nAdditionally, if you prefer to run custom analysis on experiment results you\ncan leverage the API to pull data from Convert Experiences into your own\nworkflow. If you do not have a Convert account already, sign up for a free\ndeveloper account at https://www.convert.com/api/.\n\n*[Convert API V1](/doc/v1) is still available and documentation can be found [here](/doc/v1) but using it is highly discouraged\nas it will be phased out in the future*\n",
    "version": "2.0.0"
  },
  "x-tagGroups": [
    {
      "name": "Client Authentication",
      "tags": [
        "API KEY Authentication",
        "Cookie Authentication",
        "OAuth Authorization"
      ]
    },
    {
      "name": "Common Parameters",
      "tags": [
        "Optional Fields",
        "Expandable Fields"
      ]
    },
    {
      "name": "Requests",
      "tags": [
        "User",
        "Accounts",
        "AI content",
        "Collaborators",
        "API Keys",
        "Notifications",
        "Projects",
        "SDK Keys",
        "Experiences",
        "Experience Variations",
        "Experience Sections",
        "Section Versions",
        "Version Changes",
        "Experiences Reports",
        "Experiences Heatmaps",
        "Goals",
        "Hypotheses",
        "Knowledge Bases",
        "Observations",
        "Locations",
        "Audiences",
        "Domains",
        "Cdn Images",
        "Files",
        "Tags",
        "Features",
        "Visitor Insights",
        "Visitors Data",
        "Visitor Data Placeholders",
        "OAuth",
        "Approval Requests"
      ]
    }
  ],
  "paths": {
    "/accounts/{account_id}/projects/{project_id}/sdk-keys/{sdk_key}/delete": {
      "delete": {
        "operationId": "deleteSdkKey",
        "x-mutates": true,
        "summary": "Delete an SDK key",
        "description": "Permanently revokes an SDK key, identified by its `sdk_key` value.\nOnce deleted, SDKs using this key will no longer be able to fetch configurations or track events for the associated project and environment.\n",
        "tags": [
          "SDK Keys"
        ],
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "description": "ID of the account that owns the retrieved/saved data",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "project_id",
            "in": "path",
            "required": true,
            "description": "ID of the project to be retrieved",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "sdk_key",
            "in": "path",
            "required": true,
            "description": "ID of the SDK key to be deleted",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/SuccessResponse"
          },
          "403": {
            "$ref": "#/components/responses/AccountArchivedResponse"
          },
          "503": {
            "$ref": "#/components/responses/AccountDirectoryUnavailableResponse"
          },
          "default": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.convert.com/api/v2",
      "description": "Live API server"
    },
    {
      "url": "https://apidev.convert.com/api/v2",
      "description": "DEV API server"
    },
    {
      "url": "http://apidev.convert.com:5000/api/v2",
      "description": "DEV mocked API server"
    }
  ],
  "components": {
    "securitySchemes": {
      "secretKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "See **[API Key Authentication](/reference/api-key-authentication)** for more information.\n"
      },
      "cookieAuthentication": {
        "type": "apiKey",
        "in": "cookie",
        "name": "sid",
        "description": "Cookie authentication is used against Convert's own IdentityProvider  or third party identity providers and is described more in the \"[Cookie Authentication](/reference/cookie-authentication)\" section"
      },
      "requestSigningAppId": {
        "type": "apiKey",
        "in": "header",
        "name": "Convert-Application-ID",
        "description": "HMAC request signing — the Application ID from your Convert account. See **[API Key Authentication](/reference/api-key-authentication)** for how to generate the full three-header set."
      },
      "requestSigningExpires": {
        "type": "apiKey",
        "in": "header",
        "name": "Expires",
        "description": "HMAC request signing — UNIX timestamp after which the signature expires. See **[API Key Authentication](/reference/api-key-authentication)** for how to compute it."
      },
      "requestSigningAuthorization": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "HMAC request signing — format: `Convert-HMAC-SHA256 Signature=<hex-hmac-sha256(AppID\\nExpires\\nURL\\nBody, Secret)>`. See **[API Key Authentication](/reference/api-key-authentication)** for the signing algorithm. The \"Try It\" playground cannot compute this for you; paste a pre-computed signature here or use the Bearer method instead."
      }
    },
    "responses": {
      "ErrorResponse": {
        "description": "Indicates an error occurred while processing the request. The `code` provides an HTTP status code, `message` offers a human-readable explanation or an array of validation errors, and `fields` (if present) specifies which input fields were problematic.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            }
          }
        }
      },
      "AccountArchivedResponse": {
        "description": "The request is refused because of the state of the account. The body is the standard error envelope with `code` 403, and `message` tells the two bodies apart.\n\n`ACCOUNT_ARCHIVED`: the account was archived and its database was dropped. A request for this account is refused when it uses an API key, HMAC-signed or sent as a Bearer API-key token. A request with an OAuth access token for an archived account gets 401 instead. A cookie session is refused when every account the user holds was archived. Changing the subscription of an archived account is refused too. Support restores such an account by hand.\n\n`This account has been offboarded and report data access is no longer available.`: the account was offboarded, and report data access is refused.\n\nOther 403 refusals, such as a missing permission, use the same envelope with their own `message`.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            },
            "examples": {
              "accountArchived": {
                "summary": "The account was archived",
                "value": {
                  "code": 403,
                  "message": "ACCOUNT_ARCHIVED",
                  "isError": true
                }
              },
              "accountOffboarded": {
                "summary": "The account was offboarded",
                "value": {
                  "code": 403,
                  "message": "This account has been offboarded and report data access is no longer available."
                }
              }
            }
          }
        }
      },
      "AccountDirectoryUnavailableResponse": {
        "description": "The list of accounts the user holds could not be fetched, so the request cannot continue. Only cookie sessions receive this response. The client may retry after the number of seconds in the `Retry-After` header. The body is the standard error envelope with `code` 503 and `message` `ACCOUNT_DIRECTORY_UNAVAILABLE`.\n",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before the client retries the request.",
            "schema": {
              "type": "integer"
            },
            "example": 5
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            },
            "example": {
              "code": 503,
              "message": "ACCOUNT_DIRECTORY_UNAVAILABLE"
            }
          }
        }
      },
      "SuccessResponse": {
        "description": "A generic success response, typically used for operations that don't return specific data (like deletions or some updates). The `code` is usually 200, and `message` confirms the successful action.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/SuccessData"
            }
          }
        }
      }
    },
    "schemas": {
      "ErrorData": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "fields": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "context": {
            "type": "object",
            "description": "Additional context about the error."
          }
        }
      },
      "SuccessData": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  },
  "security": [
    {
      "requestSigningAppId": [],
      "requestSigningExpires": [],
      "requestSigningAuthorization": []
    },
    {
      "secretKey": []
    },
    {
      "cookieAuthentication": []
    }
  ]
}
```