---
title: "Chat with a connection agent (plt_ scoped)"
method: POST
path: "/v1/platform/connections/{connectionId}/agents/{agentId}/chat"
tags: ["Platform"]
---

# Chat with a connection agent (plt_ scoped)

`POST /v1/platform/connections/{connectionId}/agents/{agentId}/chat`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/platform/connections/{connectionId}/agents/{agentId}/chat`
- Auth: HTTP bearer

Send a chat message to an agent provisioned on this connection, acting as the
connected end-user. Use instead of `POST /v1/agents/{id}/chat` with a plt_ key.

## Path parameters

- `connectionId` string, uuid, required
- `agentId` string, uuid, required

## Request body

- SendChatMessageRequest
  - `message` string: User message text. Optional when `messages` includes a user turn.
  - `conversation_id` string, uuid
  - `mode` string
  - `model` string
  - `provider` string
  - `system_prompt` string: Stored on new conversations when `conversation_id` is omitted.
  - `system` string: Per-request system prompt alias (same precedence as `system_prompt_override`).
  - `system_prompt_override` string: Per-request override; highest precedence except inline `messages` system role.
  - `messages` object[]: Optional OpenAI-shaped history. When set, used for LLM context instead of DB history.
    - `role` string, required
    - `content` string, required
  - `llm_api_key_vault_id` string
  - `llm_api_key_path` string

## Response `200`

Message sent (JSON or SSE stream)

## Other responses

- `402`: Payment required (LLM billing / inference allowance)
- `403`: Insufficient permissions
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)