RErecruitwithatlas
Custom Attributes

Create a project custom attribute definition

Changed on

Creates a new agency-wide custom attribute definition for project records.

For options-type attributes, provide the selectable choices via options (in display order) and optionally set multipleValues to allow multi-select. The attribute name must be unique per entity type within the agency (exact match, case-sensitive — same as the Atlas app) — a duplicate name returns 409.

post/api/v1/projects/custom-attributes

Request

Request body

namestring required

Display name. Must be unique per entity type within the agency (exact match, case-sensitive). Leading/trailing whitespace is trimmed.

type'options' | 'text_block' | 'text_line' | 'integer' | 'date' required

Data type of the attribute

multipleValuesboolean

When true and type is options, multiple options can be selected. Only allowed for options type. Defaults to false.

optionsstring[]

Selectable choices, in display order. Required (at least one value) when type is options; not allowed otherwise. Values must be unique (case-insensitive).

Example request

{
  "name": "Seniority Level",
  "type": "options",
  "options": [
    "Junior",
    "Mid",
    "Senior"
  ]
}

Response

Created project custom attribute definition

status'ok' required

Example response

{
  "data": {
    "name": "Seniority Level",
    "description": "Candidate's seniority level",
    "type": "options",
    "multipleValues": true,
    "recordType": "contract",
    "options": [
      {
        "value": "Senior"
      }
    ]
  }
}

Changes