v1

latestOpenAPI 3.1.02026-07-14801408.6 KB

/requisitions/:code/approve

Approves a requisition (must be in a compatible state). Required scope: w_requisitions. For accounts with Hiring Plan.

patch/requisitions/{code}/approve

Path parameters

codestring required

The code of the requisition

Request body

member_idstring required

The ID of the approver (required in account access tokens)

Response

200

Example response

{
  "requisitions": [
    {
      "id": "16d60890",
      "code": "REQ101",
      "job": {
        "id": "23c47225",
        "title": "Pilot"
      },
      "department": {
        "id": "1ee2e1d2",
        "name": "Flight"
      },
      "location": {
        "location_str": "California, USA",
        "country": "United States",
        "country_code": "US",
        "region": "California",
        "region_code": "CA"
      },
      "hiring_manager": {
        "id": "31169ee",
        "name": "Jack Shephard"
      },
      "owner": {
        "id": "2310f579",
        "name": "John Locke"
      },
      "plan_date": "2022-12-31",
      "salary_range": {
        "from": 60000,
        "to": 80000,
        "frequency": "year",
        "currency": "EUR"
      },
      "employment_type": "Full-time",
      "reason": "replacement",
      "state": "pending",
      "requisition_attributes": [
        {
          "name": "Level",
          "value": {
            "body": "Senior"
          }
        }
      ],
      "approval_groups": [
        {
          "id": "129cf872",
          "approvers": [
            {
              "id": "15046d4c",
              "name": "Kate Austen",
              "decision": "approved"
            }
          ]
        }
      ]
    }
  ]
}