Skip to main content

Create a new conversation thread

POST 
/api/v1/llm/create-thread

Creates a conversation thread for the authenticated user.

Use this in a guide: Build a support conversation the user can return to · Let a customer navigate your app through chat · Build a reusable assistant profile · Build a research, bulk-summary or structured-summary flow · Route an image question to a capable model · Keep a model on the providers you choose · Build a signed-in support chat that survives reconnects · Configure a support conversation that stays predictable · Complete your first support-chat turn · Let your assistant answer questions about a customer’s calendar · Profile selection and prompt versions

Request​

Responses​

Thread created successfully

Create a titled conversation; identity comes from authenticated context.​

Section ID: DOC-MA-conversations-api-createThread#example-conversations-createThread-request

Request example

{
  "title": "Travel planning",
  "tags": [
    "travel"
  ]
}

Guide request for 2. Give this conversation access to the calendar. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-integrations-tools-connections-connected-apps-04-request

Request example

{
  "conversationSettings": {
    "mcpServers": [
      {
        "serverId": "pipedream:google_calendar",
        "enabled": true
      }
    ]
  }
}

Guide request for Step 2: Start one support conversation. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-conversations-build-chat-assistant-02-request

Request example

{
  "title": "My First Thread"
}

Guide request for Step 1: Create the support thread once. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-conversations-index-01-request

Request example

{
  "title": "Support Chat"
}

Guide request for Step 1: Describe the navigation your app can perform. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-delegation-approvals-build-agent-with-tools-01-request

Request example

{
  "defaultGenerationConfig": {
    "clientTools": [
      {
        "name": "navigate_to",
        "serverId": "client",
        "description": "Navigate the app to a given screen",
        "parametersJsonSchema": {
          "type": "object",
          "properties": {
            "screen": {
              "type": "string",
              "description": "Screen identifier, e.g. \"/settings\""
            }
          },
          "required": [
            "screen"
          ]
        }
      }
    ]
  }
}

Guide request for Recipe: keep a research conversation on large-context candidates. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-model-controls-examples-01-request

Request example

{
  "title": "Long research thread",
  "defaultGenerationConfig": {
    "models": [
      "google/gemini-3.6-flash:nitro",
      "anthropic/claude-sonnet-4.6:nitro",
      "anthropic/claude-sonnet-5"
    ],
    "modelRoutingFilter": {
      "minContextLength": 128000
    }
  }
}

Guide request for Variant: keep a capability requirement for a long research thread. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-model-controls-filtering-02-request

Request example

{
  "title": "Long research thread",
  "defaultGenerationConfig": {
    "models": [
      "google/gemini-3.6-flash:nitro",
      "anthropic/claude-sonnet-4.6:nitro",
      "anthropic/claude-sonnet-5"
    ],
    "modelRoutingFilter": {
      "minContextLength": "128000"
    }
  }
}

Guide request for Variant: reuse the same assistant setup across conversations. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-conversations-configuration-json-01-request

Request example

{
  "title": "Nutrition check-in",
  "activeProfileId": "nutrition_coach"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-MA-conversations-api-createThread#example-conversations-createThread-response

Response example

{
  "thread": {
    "threadId": "example_123",
    "title": "example",
    "tags": [
      "example"
    ],
    "createdAt": "2026-09-16T12:00:00Z",
    "updatedAt": "2026-09-16T12:00:00Z",
    "externalId": "example_123"
  }
}

Illustrative response for Step 2: Start one support conversation. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-conversations-build-chat-assistant-json-02-response

Response example

{
  "thread": {
    "threadId": "b81d5345-c1f9-4fb9-b558-a6327c75b842",
    "title": "My First Thread",
    "createdAt": "2026-04-23T16:34:02.673Z",
    "updatedAt": "2026-04-23T16:34:02.673Z"
  }
}

Illustrative response for Step 1: Describe the navigation your app can perform. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-createThread#example-cookbook-managed-agents-delegation-approvals-build-agent-with-tools-json-01-response

Response example

{
  "thread": {
    "threadId": "b81d5345-c1f9-4fb9-b558-a6327c75b842"
  }
}

Document ID: DOC-MA-conversations-api-createThread. Section identities and revisions.

SectionStable reference
Create a new conversation threadDOC-MA-conversations-api-createThread#overview
RequestDOC-MA-conversations-api-createThread#request
ResponsesDOC-MA-conversations-api-createThread#responses