---
title: "Chat With Agent"
method: POST
path: "/agents/v1/{api_key}/chat"
tags: ["agents"]
---

# Chat With Agent

`POST /agents/v1/{api_key}/chat`

Send a message to an agent (no auth required).

## Path parameters

- `api_key` string, required

## Request body

- AgentChatRequest — Request to chat with an agent.
  - `message` string, required
  - `user_identifier` string, nullable
  - `user_identifier_type` string, nullable
  - `conversation_id` string, uuid, nullable
  - `extra_data` object, nullable
  - `attachments` object[], nullable

## Response `200`

Successful Response

- AgentChatResponse — Response from agent chat.
  - `response` string, required
  - `image_urls` string[], nullable
  - `file_urls` string[], nullable
  - `conversation_id` string, uuid, required
  - `message_id` string, uuid, required
  - `agent_id` string, uuid, required
  - `agent_name` string, required
  - `tokens_used` integer, nullable
  - `memories_used` integer
  - `resolution_status` string, nullable
  - `resolution_confidence` number, nullable
  - `pending_tool_call` PendingToolCall — A tool call awaiting user confirmation.
    - `approval_id` string, required
    - `tool_name` string, required
    - `tool_arguments` object, required
    - `description` string, required
  - `status` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)