> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-content-gov.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a message to a deployed agent

> Deployment-scoped agent chat. Creates a session on first call or continues one via sessionId. Project and agent are resolved from the URL.



## OpenAPI

````yaml /agent-platform/apis/conversation.json post /api/v1/project/{projectSlug}/{env}/agent/{agentSlug}/chat
openapi: 3.0.3
info:
  description: Runtime API for workflow/chat/deployment/session execution.
  title: ABL Runtime API - public/conversation
  version: 1.0.0
  x-generated: 'do not edit; source: route contracts'
servers: []
security: []
paths:
  /api/v1/project/{projectSlug}/{env}/agent/{agentSlug}/chat:
    post:
      tags:
        - Conversation
      summary: Send a message to a deployed agent
      description: >-
        Deployment-scoped agent chat. Creates a session on first call or
        continues one via sessionId. Project and agent are resolved from the
        URL.
      operationId: runtime.agent.chat
      parameters:
        - description: Project slug
          in: path
          name: projectSlug
          required: true
          schema:
            description: Project slug
            type: string
        - description: Environment tier
          in: path
          name: env
          required: true
          schema:
            description: Environment tier
            enum:
              - dev
              - staging
              - production
            type: string
        - description: Deployed agent slug
          in: path
          name: agentSlug
          required: true
          schema:
            description: Deployed agent slug
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                attachmentIds:
                  description: Attachment ids to include
                  items:
                    type: string
                  type: array
                message:
                  description: User message text
                  type: string
                metadata:
                  additionalProperties:
                    nullable: true
                  type: object
                sessionId:
                  description: Existing session id to continue the conversation
                  type: string
              required:
                - message
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  action:
                    additionalProperties:
                      nullable: true
                    type: object
                  outcome:
                    type: string
                  response:
                    type: string
                  sessionId:
                    type: string
                required:
                  - sessionId
                  - response
                type: object
          description: Success
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ErrorResponse:
      properties:
        error:
          type: string
      required:
        - error
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````