Task data model
View field support, webhooks, and list parameters for each integration on the Supported Integrations page.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | No | |
created_at | string (date-time) | No | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
updated_at | string (date-time) | No | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
name | string | No | A short human-readable title for the coding agent task. |
instructions | string | No | The natural-language instructions given to the coding agent. |
status | enum | No | Values: PENDING, RUNNING, BLOCKED, COMPLETED, FAILED, CANCELLED, EXPIRED, OTHER |
model_id | string | No | |
user_id | string | No | (reference to HrisEmployee) |
repo_url | string | No | The git repository that the coding agent works in. |
source_branch_identifier | string | No | The name of the branch that the coding agent starts its work from. |
target_branch_identifier | string | No | The name of the branch that the coding agent pushed its work to. |
pullrequest_url | string | No | The pull/merge request that the coding agent opened for its work. |
web_url | string | No | The provider's own web page for this task. |
messages | GenaiContent[] | No | The conversation between the user and the coding agent. |
messages[].role | enum | No | Values: SYSTEM, USER, ASSISTANT |
messages[].content | string | Yes | |
messages[].images | string[] | No | Images for the model to evaluate with this message, as base64 data URLs (data:image/png;base64,...). Only for models with has_vision. |
summary | string | No | The coding agent's summary of the work that it performed. |
error | string | No | The failure description (when the status is FAILED). |
files_changed | number | No | |
lines_added | number | No | |
lines_deleted | number | No | |
tokens_used | number | No | |
started_at | string (date-time) | No | When the coding agent started working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
completed_at | string (date-time) | No | When the coding agent stopped working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
agent_id | string | No | id of the genai_agent (the reusable agent/preset configuration) that runs this task. |
organization_id | string | No | id of the genai_organization (the organization or execution environment) that this task runs under. |
Are we missing anything? Let us know