Skip to main content

Delete Experience Category

Delete an experience category.

Endpointโ€‹

DELETE /v1/experience-categories/{id}

Authenticationโ€‹

Requires an API key with the experiences:write scope.

Parametersโ€‹

ParameterTypeLocationDescription
idintegerpathThe category ID

Responseโ€‹

Success (204 No Content)โ€‹

Returns no content on successful deletion.

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
401invalid_api_keyInvalid API key
403insufficient_scopeAPI key lacks experiences:write scope
404resource_not_foundCategory does not exist
409conflictCategory cannot be deleted (has experiences or child categories)

Example Requestโ€‹

curl -X DELETE "https://app.equipdash.com/api/v1/experience-categories/3" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."

Important Notesโ€‹

  • A category with experiences assigned to it may not be deletable
  • A category with child categories may need to have children removed first
  • This action cannot be undone