Skip to main content
PATCH
/
v1
/
tasks
/
{taskId}
Update a task
curl --request PATCH \
  --url https://api.trycomp.ai/v1/tasks/{taskId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "title": "Review access controls",
  "description": "Review and update access control policies",
  "status": "in_progress",
  "assigneeId": "mem_abc123",
  "approverId": "mem_abc123",
  "frequency": "monthly",
  "integrationScheduleFrequency": "daily",
  "department": "it",
  "reviewDate": "2025-01-01T00:00:00.000Z",
  "notRelevantJustification": "This control is out of scope for our SOC 2 audit."
}
'
{
  "id": "tsk_abc123def456",
  "title": "Implement user authentication",
  "status": "in_progress",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "integrationScheduleFrequency": "daily",
  "description": "Add OAuth 2.0 authentication to the platform",
  "taskTemplateId": "frk_tt_68406e353df3bc002994acef",
  "integrationLastRunAt": {}
}

Documentation Index

Fetch the complete documentation index at: https://www.trycomp.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
taskId
string
required

Unique task identifier

Example:

"tsk_abc123def456"

Body

application/json
​
title
string

Task title

Example:

"Review access controls"

​
description
string

Task description

Example:

"Review and update access control policies"

​
status
enum<string>
Available options:
todo,
in_progress,
in_review,
done,
not_relevant,
failed
Example:

"in_progress"

​
assigneeId
string | null

Assignee member ID, or null to unassign

Example:

"mem_abc123"

​
approverId
string | null

Approver member ID, or null to unassign

Example:

"mem_abc123"

​
frequency
enum<string>
Available options:
daily,
weekly,
monthly,
quarterly,
yearly
Example:

"monthly"

​
integrationScheduleFrequency
enum<string>

Cadence for running the integration check attached to this task

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

"daily"

​
department
enum<string>
Available options:
none,
admin,
gov,
hr,
it,
itsm,
qms
Example:

"it"

​
reviewDate
string<date-time>
Example:

"2025-01-01T00:00:00.000Z"

​
notRelevantJustification
string

Required justification when marking evidence tasks as not_relevant

Example:

"This control is out of scope for our SOC 2 audit."

Response

Task updated 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
object

Task template ID

Example:

"frk_tt_68406e353df3bc002994acef"

​
integrationLastRunAt
object

Last successful integration check run timestamp