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

# Chat With Agent

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

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/agents/v1/{api_key}/chat`
- Auth: none declared

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.dev/meganova/apis/meganova-api.md) - [All operations](https://skmtc.dev/meganova/apis/meganova-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/meganova-api/revisions/c683584f6060?raw)