---
title: "POST /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads"
method: POST
path: "/api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads"
---

# POST /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads

`POST /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads`

## Path parameters

- `projectUuid` string, required
- `agentUuid` string, required

## Request body

- ApiAiAgentThreadCreateRequest
  - `modelConfig` AiAgentModelConfig
    - `reasoning` boolean
    - `modelProvider` string, required
    - `modelName` string, required
  - `context` AiPromptContextItemInput[]
    - union
      - object
        - `runtimeOverrides` AiChartRuntimeOverrides — Runtime state captured at pin time for a chart context. When a user pins a chart from a dashboard view, these are the dashboard-level overrides that were applied to the chart on screen at that moment.
          - `dateZoom` DateZoom
            - `xAxisFieldId` string
            - `granularity` union
              - …
          - `dashboardParameters` ParametersValuesMap — Construct a type with a set of properties K of type T
          - `dashboardFilters` DashboardFilters
            - `tableCalculations` DashboardFilterRule[], required
              - …
            - `metrics` DashboardFilterRule[], required
              - …
            - `dimensions` DashboardFilterRule[], required
              - …
        - `chartSlug` string, nullable
        - `chartUuid` string, required
        - `type` 'chart', required
      - object
        - `runtimeOverrides` AiDashboardRuntimeOverrides
          - `dateZoom` DateZoom
            - `xAxisFieldId` string
            - `granularity` union
              - …
          - `dashboardParameters` ParametersValuesMap — Construct a type with a set of properties K of type T
          - `dashboardFilters` AiDashboardFilters
            - `tableCalculations` AiDashboardFilterRule[], required
              - …
            - `metrics` AiDashboardFilterRule[], required
              - …
            - `dimensions` AiDashboardFilterRule[], required
              - …
          - `activeTab` AiDashboardActiveTab
            - `name` string, required
            - `uuid` string, required
        - `dashboardSlug` string, nullable
        - `dashboardUuid` string, required
        - `type` 'dashboard', required
      - object
        - `promptUuid` string, nullable
        - `threadUuid` string, required
        - `type` 'thread', required
      - object
        - `path` string, required
        - `type` 'file', required
      - object
        - `fullName` string, required
        - `type` 'repository', required
      - object
        - `prUrl` string, required
        - `type` 'pull_request', required
      - object
        - `fingerprint` string, required
        - `type` 'proposed_change', required
      - object
        - `fingerprint` string, required
        - `type` 'review_finding', required
      - object
        - `previewProjectUuid` string, required
        - `type` 'preview_environment', required
  - `prompt` string

## Response `200`

Success

- ApiAiAgentThreadCreateResponse
  - `results` AiAgentThreadSummary, required
    - `user` AiAgentUser, required
      - `name` string, required
      - `uuid` string, required
    - `firstMessage` object, required
      - `message` string, required
      - `uuid` string, required
    - `titleGeneratedAt` string, nullable, required
    - `title` string, nullable, required
    - `createdFrom` 'slack' | 'web_app' | 'evals' | 'scheduler', required
    - `createdAt` string, required
    - `agentUuid` string, required
    - `uuid` string, required
  - `status` 'ok', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lightdash/apis/lightdash-api.md) · [All operations](https://skmtc.net/lightdash/apis/lightdash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightdash/lightdash-api/versions/40c933755c9a/schema)