Sign in
Departments

Create a new department.

post/v1/departments

Request body

namestring required

a string with no leading or trailing whitespace

Response

Success

idstring required

The unique public id of the department

namestring required
createdAtstring required

a string to be decoded into a Date

Example response

{
  "id": "dpt_1234",
  "name": "Engineering"
}

Changes

Changed in 4 of the 20 revisions of this API.716

  • a896c17cf98852See the full diff
    • ▲

      the response's body type/format changed from object/ to / for status 403

      response-body-type-changed

    • ▲

      removed the required property _tag from the response with the 403 status

      response-required-property-removed

    • ▲

      removed the required property message from the response with the 403 status

      response-required-property-removed

    • ▲

      removed the required property requiredPermissions from the response with the 403 status

      response-required-property-removed

    • ▲

      removed the success response with the status 200

      response-success-status-removed

    • ○

      added MissingRequiredPermissions ApiNotEnabled to the response body anyOf list for the response status 403

      response-body-any-of-added

    • ○

      added the success response with the status 201

      response-success-status-added

  • 6cfbdf910b801See the full diff
    • ●

      added the new company:workplaces enum value to the requiredPermissions/items/scope response property for the response status 403

      response-property-enum-value-added

  • 768d9cb8d8d923See the full diff
    • ▲

      the requiredPermissions/items/ response property's minItems was decreased from 2 to 0 for the response status 403

      response-property-min-items-decreased

    • ▲

      the requiredPermissions/items/ response's property type/format changed from array/ to object/ for status 403

      response-property-type-changed

    • ○

      removed subschema #1 subschema #2 from the requiredPermissions/items/ response property 'prefixItems' list for the response status 403

      response-property-prefix-items-removed

    • ○

      added the required property requiredPermissions/items/level to the response with the 403 status

      response-required-property-added

    • ○

      added the required property requiredPermissions/items/scope to the response with the 403 status

      response-required-property-added

  • 787281d7e9a21See the full diff
    • ○

      endpoint added

      endpoint-added