Nominations

Nominations can represent either an application of a candidate who has actively applied for a job OR an active consideration of a candidate for a job by a recruiter, marketplace, etc. Generally, a nom

Relationships:

  • Candidate to Nominations is 1-Many

  • Nomination Stages to Nominations is 1-1. Each nomination can only be in one stage at a given time.

Create a Nomination

POST https://endorsed.ai/api/v1/nominations

Creates a new Nomination and returns the Nomination's UUID id.

Headers

Request Body

{
  "is_error": false,
  "result": {
    "id": "6427f970-70c0-4b42-8fae-5609cefbb1bc"
  }
}

Examples:

curl -X POST "${BASE_URL}/api/v1/nominations" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-d '{
  "job_id": "39cce06d-148f-44ba-ad63-3ddc825339b6",
  "candidate_id": "7240574b-9870-4293-a0d1-44fe77c59420",
  "current_nomination_stage_id": "602f023c-53a2-4886-9b36-6157e70b2c93",
  "applied_at": "2023-09-30T06:35:16.000Z",
  "remote_id": "remote-id_from-originating-system"
}'

Get an existing Nomination

GET https://endorsed.ai/api/v1/nominations/{id}

Get an existing Nomination by it's UUID id or by a remote id. Remote ids MUST be structured by remote.<id>

Path Parameters

Headers

{
  "is_error": false,
  "result": {
    "id": "6427f970-70c0-4b42-8fae-5609cefbb1bc",
    "job_id": "3c2914bb-b31b-47ab-8976-afaa2d995503",
    "candidate_id": "b8c76214-d518-4d69-9aab-77b0166696d2",
    "current_nomination_stage_id": "01d6e7e3-44fb-436b-b593-fa3e376caf08",
    "applied_at": "2023-09-25T22:06:01.000Z",
    "remote_id": "27bac5c5-7447-4714-8696-0aa2fbc78ffa",
    "created_at": "2023-09-25T22:06:01.000Z",
    "modified_at": "2023-09-25T22:06:01.000Z"
  }
}

Examples:

curl -X GET "${BASE_URL}/api/v1/nominations/remote.remote-id_from-originating-system" \
-H "Authorization: Bearer ${ACCESS_TOKEN}"

Update an existing Nomination

PUT https://endorsed.ai/api/v1/nominations/{id}

Updates an existing Nomination by it's UUID id.

Headers

Request Body

{
  "is_error": false,
  "result": {
    "id": "6427f970-70c0-4b42-8fae-5609cefbb1bc"
  }
}

Examples:

curl -X PUT "${BASE_URL}/api/v1/nominations/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-d '{
  "current_nomination_stage_id": "602f023c-53a2-4886-9b36-6157e70b2c93",
  "applied_at": "2023-12-30T06:35:16.000Z"
}'

Last updated

© 2024 Endorsed