Skip to main content
DELETE
Unassign a certification

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

personId
string
required

The person's email address — or the opaque person id from any response.

Example:

"ada@example.com"

certificationId
string
required

Certification id.

Example:

"87"

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"