---
title: "Chat"
method: POST
path: "/public_api/agent_apps/{app_uuid}/chat"
tags: ["Agent"]
---

# Chat

`POST /public_api/agent_apps/{app_uuid}/chat`

This endpoint allows you to send a message (chat) to an Agent app. You can include inputs with your message which will be passed to the app.

## Path parameters

- `app_uuid` string, required

## Request body

- ChatPayload
  - `message` string — The message to send to the agent
  - `session_id` string — The session id of the chat. Use the session_id to send a message to an existing conversation. If not present, a new session will be created after sending the first message.
  - `inputs` object — Optional inputs to send along with the message.

## Response `200`

Message sent

- object
  - `result` Result — unresolved $ref
  - `airops_app_execution` Execution
    - `id` string, required
    - `status` 'pending' | 'running' | 'error' | 'success' | 'cancelled' | 'review_needed', required
    - `airops_apps_version_id` integer
    - `conversation_id` string
    - `credits_used` integer
    - `error_code` string
    - `error_message` unknown
    - `feedback` 'positive' | 'neutral' | 'negative'
    - `inputs` object
    - `output` object
    - `runtime` integer — The time it took to execute the app in seconds
    - `source` string
    - `uuid` string
    - `workspace_id` integer
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401` — Authentication error

---

[API](https://skmtc.dev/airops/apis/api-v1.md) · [All operations](https://skmtc.dev/airops/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/airops/api-v1/revisions/1a78a02c5f7a/schema)