> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentictrust.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a conversation

> Creates a new conversation. Optionally associate it with an end user by passing `endUserExternalId`.



## OpenAPI

````yaml /openapi.json post /chat/conversations
openapi: 3.0.3
info:
  title: Agentic Trust API
  description: >-
    Runtime API for the Agentic Trust AI customer support platform. Use these
    endpoints to manage conversations, send messages, verify user identity, and
    collect feedback.
  version: 1.0.0
  contact:
    name: Agentic Trust Support
    email: security@agentictrust.com
servers:
  - url: https://platform.agentictrust.com/api/v1
    description: Production
security:
  - ApiKeyHeader: []
tags:
  - name: Widget
    description: Widget configuration endpoints.
  - name: Chat
    description: Conversation and message endpoints.
  - name: Identity
    description: User identity verification endpoints.
  - name: Feedback
    description: Conversation feedback endpoints.
paths:
  /chat/conversations:
    post:
      tags:
        - Chat
      summary: Create a conversation
      description: >-
        Creates a new conversation. Optionally associate it with an end user by
        passing `endUserExternalId`.
      operationId: createConversation
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                endUserExternalId:
                  type: string
                  description: External identifier for the end user.
      responses:
        '200':
          description: Conversation created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversationId:
                    type: string
                required:
                  - conversationId
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
  headers:
    RateLimitLimit:
      schema:
        type: integer
      description: Maximum requests allowed in the current window.
    RateLimitRemaining:
      schema:
        type: integer
      description: Remaining requests in the current window.
    RateLimitReset:
      schema:
        type: integer
      description: Unix timestamp when the rate limit window resets.
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key in `lum_pk_*` format. Pass via `x-api-key` header or
        `Authorization: Bearer <key>`.

````