Create

Description

Create a task for a specific case.

Request

HTTP Method: POST

Parameter Description
description The task description.
assignee_emails Optional An array of user emails to assign to the task.
Path Parameter Description
case_id The ID of the case to create the task for.

Sample request

curl -X POST \
  https://<<META.tenant.domain>>/api/v2/cases/<<case_id>>/tasks \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
  "description": "Review security logs for suspicious activity",
  "assignee_emails": ["user1@example.com", "user2@example.com"]
}'

Response

A successful request will return a JSON object representing the created task.

Field description

Parameter Description
task The created task object.

Task object fields

Parameter Description
id The task ID.
description The task description.
completed Boolean indicating whether the task is completed.
assignees An array of users assigned to the task.
created_at ISO 8601 Timestamp representing the date and time the task was created at.
updated_at ISO 8601 Timestamp representing the date and time the task was updated at.

Assignee object fields

Parameter Description
id The user ID.
email The user email.
first_name The user's first name.
last_name The user's last name.

Sample response

{
  "task": {
    "id": 1,
    "description": "Review security logs for suspicious activity",
    "completed": false,
    "assignees": [
      {
        "id": "123",
        "email": "user1@example.com",
        "first_name": "John",
        "last_name": "Doe"
      },
      {
        "id": "456",
        "email": "user2@example.com",
        "first_name": "Jane",
        "last_name": "Smith"
      }
    ],
    "created_at": "2024-03-25T15:40:39Z",
    "updated_at": "2024-03-25T15:40:39Z"
  }
}
Was this helpful?