Skip to main content
DELETE
Delete a level

Authorizations

Authorization
string
header
required

An API key issued by a company administrator — an environment prefix (production: sdb_live_) followed by 32 characters. The prefix identifies the environment and MUST NOT be hard-coded or validated by clients; treat the whole key as opaque. Shown exactly once at creation; only a one-way hash is stored.

Scopes (granted per key on the create screen; :write never implies :read):

  • skills:read
  • skills:write
  • people:read
  • people:write
  • careers:read
  • careers:write
  • training:read
  • training:write
  • flags:read
  • flags:write
  • org:read
  • org:write
  • assessments:read
  • learning:read
  • learning:write
  • certifications:read
  • certifications:write
  • assessments:write
  • proficiency:read
  • proficiency:write
  • surveys:read
  • surveys:write
  • labels:read
  • labels:write

Headers

Idempotency-Key
string

Any unique string (at most 200 characters). Retrying with the same key and identical content replays the stored response for 24h instead of executing twice.

Maximum string length: 200

Path Parameters

id
string
required

Opaque resource id.

levelId
string
required

Opaque resource id.

Query Parameters

confirm
boolean

The literal string true confirms the delete despite assigned people.

Response

Validation failed (https://help.skillsdb.com/api-docs/errors/validation-error)

type
string
required

A URI identifying the problem type — always resolves to a documentation page.

Example:

"https://help.skillsdb.com/api-docs/errors/validation-error"

title
string
required
Example:

"Validation failed"

status
number
required
Example:

400

detail
string
required

Human-readable explanation specific to this occurrence.

Example:

"limit must be between 1 and 200"

instance
string
required
Example:

"/api/v1/people"

requestId
string
required

Matches the X-Request-Id response header — quote it when contacting support.

Example:

"0192c2f1-6f4e-7ab3-b1c4-5f6a7b8c9d0e"

errors
object[]

Field-level failures, present on validation-error problems.

error
enum<string>

Present only on a 403 when the workspace's trial has expired, so API access is suspended.

Available options:
trial_expired
Example:

"trial_expired"

upgrade_url
string

Present only alongside error: trial_expired: where a workspace admin upgrades to restore API access.

Example:

"https://app.skillsdb.com/settings/billing"