# Models

## The Task object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"Task":{"type":"object","properties":{"Id":{"type":"string"},"Reference":{"$ref":"#/components/schemas/TaskReference","description":"Identifies the partner by ID and custom values."},"Details":{"$ref":"#/components/schemas/TaskDetails","description":"Title of the request."},"Attachments":{"type":"array","items":{"$ref":"#/components/schemas/Attachment"},"description":"Details about each attachment."},"DueDate":{"type":"string","format":"date-time","description":"Date and time at which the task is due. Displayed in ISO 8601 format."},"AssigneeUser":{"$ref":"#/components/schemas/User","description":"Name of the user of the partner account that the task is assigned to."},"AssigneeAccount":{"type":"string","description":"Name of the partner account that the task is assigned to."},"TotalActions":{"type":"integer","description":"Total number of actions that have been recorded for this task."},"Actions":{"type":"array","description":"Describes actions that have occurred on this task.","items":{}},"TotalComments":{"type":"integer","description":"Total number of comments that have been recorded for this task."},"Comments":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"Details about each comment on this task."},"DateCreated":{"type":"string","format":"date-time","description":"The date and time the task was created."},"DateLastUpdated":{"type":"string","format":"date-time","description":"The date and time the task was last updated."},"CreatedBy":{"$ref":"#/components/schemas/User","description":"Name of the user that created the task."},"LastUpdatedBy":{"$ref":"#/components/schemas/User","description":"Name of the user that last updated the task."}}},"TaskReference":{"type":"object","properties":{"PartnerId":{"type":"integer","description":"Unique identifier of the partner this task is about."},"PartnerValue1":{"type":"string","description":"Custom partner tracking value 1."},"PartnerValue2":{"type":"string","description":"Custom partner tracking value 2."},"PartnerValue3":{"type":"string","description":"Custom partner tracking value 3."}}},"TaskDetails":{"type":"object","properties":{"Summary":{"type":"string"},"Description":{"type":"string"},"Urgent":{"type":"boolean"},"State":{"type":"string","enum":["NEW","INPROGRESS","DUPLICATE","INVALID","BLOCKED","COMPLETED","APPROVED"]},"Type":{"type":"string","enum":["COMPLIANCE","TECHNICAL","GENERAL","CREATIVE","FINANCE","CONTRACTS","ANALYTICS","SEARCH_ENGINE_MONITORING"]},"SubtypeId":{"type":"integer","nullable":true},"SubtypeName":{"type":"string","nullable":true},"ResolutionId":{"type":"string","nullable":true},"ResolutionName":{"type":"string","nullable":true}}},"Attachment":{"type":"object","properties":{"Id":{"type":"string","description":"Unique identifier for the attachment."},"Filename":{"type":"string","description":"Original filename of the attachment."},"Location":{"type":"string","format":"uri","description":"URL to download the attachment."}}},"User":{"type":"object","properties":{"Username":{"type":"string","description":"The user's username."},"EmailAddress":{"type":"string","format":"email","description":"The user's email address."}}},"Comment":{"type":"object","properties":{"Id":{"type":"integer","description":"Unique identifier for the comment."},"Comment":{"type":"string","description":"The comment text."},"Commenter":{"type":"string","description":"Name of the user who posted the comment."},"Attachments":{"type":"array","description":"Details about each attachment on the comment.","items":{"$ref":"#/components/schemas/Attachment"}}}}}}}
```

## The TaskReference object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"TaskReference":{"type":"object","properties":{"PartnerId":{"type":"integer","description":"Unique identifier of the partner this task is about."},"PartnerValue1":{"type":"string","description":"Custom partner tracking value 1."},"PartnerValue2":{"type":"string","description":"Custom partner tracking value 2."},"PartnerValue3":{"type":"string","description":"Custom partner tracking value 3."}}}}}}
```

## The TaskDetails object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"TaskDetails":{"type":"object","properties":{"Summary":{"type":"string"},"Description":{"type":"string"},"Urgent":{"type":"boolean"},"State":{"type":"string","enum":["NEW","INPROGRESS","DUPLICATE","INVALID","BLOCKED","COMPLETED","APPROVED"]},"Type":{"type":"string","enum":["COMPLIANCE","TECHNICAL","GENERAL","CREATIVE","FINANCE","CONTRACTS","ANALYTICS","SEARCH_ENGINE_MONITORING"]},"SubtypeId":{"type":"integer","nullable":true},"SubtypeName":{"type":"string","nullable":true},"ResolutionId":{"type":"string","nullable":true},"ResolutionName":{"type":"string","nullable":true}}}}}}
```

## The Attachment object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"Attachment":{"type":"object","properties":{"Id":{"type":"string","description":"Unique identifier for the attachment."},"Filename":{"type":"string","description":"Original filename of the attachment."},"Location":{"type":"string","format":"uri","description":"URL to download the attachment."}}}}}}
```

## The User object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"User":{"type":"object","properties":{"Username":{"type":"string","description":"The user's username."},"EmailAddress":{"type":"string","format":"email","description":"The user's email address."}}}}}}
```

## The Comment object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Tasks","version":"v13"},"components":{"schemas":{"Comment":{"type":"object","properties":{"Id":{"type":"integer","description":"Unique identifier for the comment."},"Comment":{"type":"string","description":"The comment text."},"Commenter":{"type":"string","description":"Name of the user who posted the comment."},"Attachments":{"type":"array","description":"Details about each attachment on the comment.","items":{"$ref":"#/components/schemas/Attachment"}}}},"Attachment":{"type":"object","properties":{"Id":{"type":"string","description":"Unique identifier for the attachment."},"Filename":{"type":"string","description":"Original filename of the attachment."},"Location":{"type":"string","format":"uri","description":"URL to download the attachment."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v13/reference/tasks/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.