Skip to main content
GET
List tasks

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

includeRelations
string

Include controls and automations with runs

Response

Tasks retrieved successfully

id
string
required

Unique identifier for the task

Example:

"tsk_abc123def456"

title
string
required

Task title

Example:

"Implement user authentication"

status
enum<string>
required

Task status

Available options:
todo,
in_progress,
done,
blocked
Example:

"in_progress"

createdAt
string<date-time>
required

Task creation timestamp

Example:

"2024-01-15T10:30:00Z"

updatedAt
string<date-time>
required

Task last update timestamp

Example:

"2024-01-15T10:30:00Z"

integrationScheduleFrequency
enum<string>
required

Cadence for running the integration check attached to this task

Available options:
daily,
weekly,
monthly,
quarterly,
yearly
Example:

"daily"

description
string

Task description

Example:

"Add OAuth 2.0 authentication to the platform"

taskTemplateId
string | null

Task template ID

Example:

"frk_tt_68406e353df3bc002994acef"

integrationLastRunAt
string<date-time> | null

Last successful integration check run timestamp

evidenceChecklist
string[]

What an auditor needs to see in the evidence for this task, approved by Comp AI. Returned by GET /v1/tasks/{taskId}; empty when the task has no approved checklist.

Example:
evidenceAwaitingReviewCount
number

How many evidence files on this task no person has marked as reviewed yet. Returned by GET /v1/tasks?includeRelations=true.

Example:

2