Departments

POST /v1/departments

POST /v1/departments

Required scopes: departments:write

post/v1/departments

Request

  • Base URL: https://api.yardstick.team
  • URL: https://api.yardstick.team/v1/departments
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Supported for safe retry. Reuse the same key to receive the cached response without repeating the operation.

X-Request-Idstring

Optional caller-supplied request identifier. Values must match ^[A-Za-z0-9_-]{1,128}$; a valid value is echoed in the response X-Request-Id header, otherwise the API generates one.

Request body

namestring required
descriptionstring nullable
slugstring

Response

Created

idstring required

Display id, e.g. dpt_<base32>

object'department' required
organization_idstring required

Display id, e.g. org_<base32>

namestring required
slugstring required
descriptionstring nullable required
created_atstring nullable required

ISO-8601 UTC

updated_atstring nullable required

ISO-8601 UTC

Changes

No recorded changes to this operation across all 1 revision of this API.