Jobs
A company's job to which candidates may apply.
Create a job
POST
https://endorsed.ai/api/v1/jobs
Creates a new job and returns the job's UUID id.
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Authorization header containing the Bearer Access Token from the |
Content-Type | string | Must be |
Request Body
Name | Type | Description |
---|---|---|
title* | string | The title of the job |
description* | string | The description of the job |
status* | string | The current status of the job:
|
job_posting_urls | string[] | List of publicly visible job posting urls |
remote_id* | string | The
of the job from the originating system |
auto_evaluation_behavior | string | The automatic evaluation behavior of the job (see Bring AI-powered evaluations to your users):
|
default_nomination_stage_id | string | The default nomination stage id (UUID) to be used for Endorsed to automatically generate nominations. Required if the |
Examples:
Get an existing job
GET
https://endorsed.ai/api/v1/jobs/{id}
Get an existing job by it's UUID id or by a remote id. Remote ids MUST be structured by remote.<id>
Path Parameters
Name | Type | Description |
---|---|---|
id* | string | UUID id of the job |
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Authorization header containing the Bearer Access Token from the |
Examples:
Update or upserts an existing job
PUT
https://endorsed.ai/api/v1/jobs/{id}
Updates an existing job by it's UUID id or upserts a job by a remote id. Remote ids MUST be structured by remote.<id>
.
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Authorization header containing the Bearer Access Token from the |
Content-Type | string | Must be |
Request Body
Name | Type | Description |
---|---|---|
title* | string | The title of the job |
description* | string | The description of the job |
status* | string | The current status of the job:
|
job_posting_urls | string[] | List of publicly visible job posting urls |
auto_evaluation_behavior | string | The automatic evaluation behavior of the job (see Bring AI-powered evaluations to your users):
|
default_nomination_stage_id | string | The default nomination stage id (UUID) to be used for Endorsed to automatically generate nominations. Required if the |
Examples:
Partially update an existing job
PATCH
https://endorsed.ai/api/v1/jobs/{id}
Partially updates an existing job by it's UUID id.
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Authorization header containing the Bearer Access Token from the |
Content-Type | string | Must be |
Request Body
Name | Type | Description |
---|---|---|
title | string | The title of the job |
description | string | The description of the job |
status | string | The current status of the job:
|
job_posting_urls | string[] | List of publicly visible job posting urls |
auto_evaluation_behavior | string | The automatic evaluation behavior of the job (see Bring AI-powered evaluations to your users):
|
default_nomination_stage_id | string | The default nomination stage id (UUID) to be used for Endorsed to automatically generate nominations. Required if the |
Examples:
Last updated