# List all Fin Tasks

You can fetch a list of all Fin Tasks (AI agent workflows) configured for your workspace.

Endpoint: GET /fin/tasks
Version: Preview
Security: bearerAuth

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `type` (string)
    Always list.
    Enum: "list"

  - `data` (array)
    A list of Fin Task objects.

  - `data.type` (string)
    Always task.
    Example: task

  - `data.id` (string)
    The unique identifier for the Fin Task.
    Example: 1

  - `data.title` (string)
    The title of the Fin Task.
    Example: Refund request

  - `data.description` (string)
    The description of the Fin Task.
    Example: Handles refund requests end to end

  - `data.state` (string)
    Whether the Fin Task is live or still a draft.
    Enum: "live", "draft"

  - `data.created_at` (string)
    The time the Fin Task was created, as an ISO 8601 timestamp.
    Example: 2026-01-24T10:01:20Z

  - `data.updated_at` (string)
    The last time the Fin Task was updated, as an ISO 8601 timestamp.
    Example: 2026-01-24T10:01:20Z

  - `data.segment_ids` (array)
    The ids of the audience segments the Fin Task is available to. Empty when it has none.
    Example: [12]

  - `total_count` (integer)
    The total number of Fin Tasks.
    Example: 1

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (any, required)
    A string indicating the kind of error, used to further qualify the HTTP response code. A few request validation errors send an HTTP status code as an integer here instead, for example `422`.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid