Skip to content

Fin Tasks

Everything about your Fin Tasks, the AI agent workflows that Fin can run.

Fin Task

A Fin Task is an AI agent workflow that Fin can run.

typestring

Always task.

Example:"task"
idstring

The unique identifier for the Fin Task.

Example:"1"
titlestring

The title of the Fin Task.

Example:"Refund request"
descriptionstring

The description of the Fin Task.

Example:"Handles refund requests end to end"
statestring

Whether the Fin Task is live or still a draft.

Enum:"live""draft"
Example:"live"
created_atstring, (date-time)

The time the Fin Task was created, as an ISO 8601 timestamp.

Example:"2026-01-24T10:01:20Z"
updated_atstring, (date-time)

The last time the Fin Task was updated, as an ISO 8601 timestamp.

Example:"2026-01-24T10:01:20Z"
segment_idsArray of integers

The ids of the audience segments the Fin Task is available to. Empty when it has none.

Example:
[ 12 ]
{ "type": "task", "id": "1", "title": "Refund request", "description": "Handles refund requests end to end", "state": "live", "created_at": "2026-01-24T10:01:20Z", "updated_at": "2026-01-24T10:01:20Z", "segment_ids": [ 12 ] }