Docs
Delete Resource State
DELETE /resource-states/{resourceStateId}
DELETE
/resource-states/{resourceStateId}Required Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Permanently removes a resource state from the event.
Delete is blocked if the state is referenced by any rule threshold (ResultingStateId) or by any state record (StateId). Deactivate via isActive=false on the Update endpoint instead when the state is still referenced by historical data.
Requires EventSettings permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| resourceStateId | Guid | Required | The ID of the state to delete. |
Response
200 OK — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |
NOT_FOUND | 404 | Resource state not found on this event. |
BAD_REQUEST | 400 | State is referenced by a rule threshold or a state record. Deactivate via isActive=false instead. |