Skip to main content
GET
Get a task

Authorizations

X-API-KEY
string
header
required

Path Parameters

task_id
string
required

A task ID from search, such as conversation-184532 or form-submission-45.

Pattern: ^(conversation|form-submission)-\d+$
Example:

"conversation-184532"

Response

The task.

id
string
Example:

"conversation-184532"

url
string
Example:

"https://answeringagent.com/dashboard/conversations/184532"

title
string | null
status
enum<string>
Available options:
open,
in_progress,
on_hold,
done
assignee
object

A team member. The id is what assigned_to and report filters.team_member_ids take.

category

A category key. Conversations, tasks, and reports share one list. A form task has form. GET /reports/metrics lists every key with its label under categories. Older records can have a retired key that is not in that list.

Example:

"cancellation"

priority
enum<string>
Available options:
low,
medium,
high,
urgent,
normal
created_at
string<date-time> | null

When the source conversation started or the form was submitted. Not when the AI created the task.

customer
object

From the conversation's contact, or from the form submission for a form task.

conversation
object | null
form
object | null
description
string | null
Maximum string length: 5000