---
title: "Task data model"
url: "https://docs.unified.to/genai/task/model"
description: "API reference for Task data model. Launch multiple pre-built Task integrations today with zero maintenance — all through a single API."
---
# Task data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/genai/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**name**string 

A short human-readable title for the coding agent task.

**instructions**string 

The natural-language instructions given to the coding agent.

**status** enum

Valid values:

 "PENDING" 

 "RUNNING" 

 "BLOCKED" 

 "COMPLETED" 

 "FAILED" 

 "CANCELLED" 

 "EXPIRED" 

 "OTHER" 

**model\_id**string 

**user\_id**string 

(reference to HrisEmployee)

**repo\_url**string 

The git repository that the coding agent works in.

**source\_branch\_identifier**string 

The name of the branch that the coding agent starts its work from.

**target\_branch\_identifier**string 

The name of the branch that the coding agent pushed its work to.

**pullrequest\_url**string 

The pull/merge request that the coding agent opened for its work.

**web\_url**string 

The provider's own web page for this task.

**messages** array 

The conversation between the user and the coding agent.

**summary**string 

The coding agent's summary of the work that it performed.

**error**string 

The failure description (when the status is FAILED).

**files\_changed**number 

**lines\_added**number 

**lines\_deleted**number 

**tokens\_used**number 

**started\_at**date 

When the coding agent started working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**completed\_at**date 

When the coding agent stopped working on the task. (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**agent\_id**string 

id of the genai\_agent (the reusable agent/preset configuration) that runs this task.

**organization\_id**string 

id of the genai\_organization (the organization or execution environment) that this task runs under.

**raw**any

## Embedded objects

The fields below reference the following embedded objects, each documented as a table of its own fields.

### GenaiContent

| Field | Type | Required | Description |
|---|---|---|---|
| role | string enum: SYSTEM, USER, ASSISTANT |  |  |
| content | string | Yes |  |