Skip to main content
DELETE
Delete Workforce Training
← Own Workforce API
Deprecated. Use POST /v2/own-workforce/trainings/delete: many trainings per request by id, idempotent, deleted asynchronously as an ingest job, with webhooks. This endpoint keeps working; its responses carry Deprecation and Link: </v2/own-workforce/trainings/delete>; rel="successor-version" headers. A removal date (Sunset) will be announced in the changelog with notice.
Delete a single training record. Irreversible, and there is no endpoint that creates one back — restoring it means re-importing through the Imports API. Deleting a training changes the reported training hours for every period it fell in.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
Training UUIDExample: 3d9b0a11-2c4e-4f6a-8b1d-5e7f9a0c2d4e

Response

204 No Content with an empty body.

Example

Common Errors

401 Unauthorized

Cause: the key is invalid or revoked (INVALID_API_KEY), expired (API_KEY_EXPIRED), belongs neither to the organization in x-organization-id nor to one of its parents (API_KEY_ORG_MISMATCH), or has no owner (API_KEY_NO_OWNER). A request carrying no credentials at all answers AUTHENTICATION_REQUIRED. See Errors.

403 Forbidden

Cause: the key’s owner is not an enabled member of the organization, or their role cannot write.

404 Not Found

Cause: no training with that id inside your perimeter. A record whose employee belongs to another organization answers 404, never 403.

Bulk delete trainings

Delete many by id

Bulk delete by filters

Delete a filtered set