Create a task

POST

/tasks

Creates a non-private task. A task may be associated with an account-owned candidate or job.

Permissions

tasks.write

Safe retries

Send an Idempotency-Key. Retry the same request with the same key to avoid repeating the write. See Safe retries & idempotency.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Mutation applied or safely replayed.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠429

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cvviz.com/v1/tasks' \
--header 'Idempotency-Key: cvviz-integration-operation-001' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "note": "Follow up with the candidate.",
    "entityType": "none",
    "entityId": 501,
    "dueDate": "2019-08-24T14:15:22.123Z",
    "assignedTo": 18
}'

Response Example

200 - Example 1

{
    "data": {
        "id": 7301,
        "note": "Follow up with the candidate.",
        "entityType": "none",
        "entityId": 0,
        "dueDate": "2019-08-24T14:15:22.123Z",
        "assignedTo": 0,
        "assignedToName": "string",
        "isCompleted": false,
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

List tasks

Update a task

Create a task

Permissions#

Safe retries#

Request

Responses

Permissions

Safe retries