---
title: "POST /v2/agent/{agentId}/add-message"
method: POST
path: "/v2/agent/{agentId}/add-message"
---

# POST /v2/agent/{agentId}/add-message

`POST /v2/agent/{agentId}/add-message`

Permite adicionar uma mensagem ao contexto da conversa, muito usado para quando fizer um disparo ativo por outras ferramentas e precisa adicionar essa mensagem ao contexto da conversa.

## Path parameters

- `agentId` string, required

## Request body

- union
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `prompt` string, required — Texto a ser salvo no contexto
    - `role` string — define se é uma mensagem do usuário ou do agente, 'user' ou 'assistant' default: 'assistant'
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `prompt` string, required — Texto a ser salvo no contexto
    - `image` string, required — URL da imagem
    - `role` string — define se é uma mensagem do usuário ou do agente, 'user' ou 'assistant' default: 'assistant'
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `audio` string, required — URL do áudio
    - `role` string — define se é uma mensagem do usuário ou do agente, 'user' ou 'assistant' default: 'assistant'
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `video` string, required — URL do vídeo
    - `prompt` string — Texto para o agente responder/caption do vídeo
    - `role` string — define se é uma mensagem do usuário ou do agente, 'user' ou 'assistant' default: 'assistant'
  - object
    - `contextId` string, required — ID externo para identificar o cliente
    - `document` string, required — URL do documento a ser enviado
    - `prompt` string — Texto para o agente responder/caption do documento
    - `role` string — define se é uma mensagem do usuário ou do agente, 'user' ou 'assistant' default: 'assistant'

## Response `200`

Resposta do agente

- object
  - `message` string — Resposta do agente
  - `images` string[]
  - `audios` string[]

## Other responses

- `400` — Erro inesperado
- `403` — Erro de token

---

[API](https://skmtc.net/gptmaker/apis/openapi-gpt-maker.md) · [All operations](https://skmtc.net/gptmaker/apis/openapi-gpt-maker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gptmaker/openapi-gpt-maker/versions/bda09b3eba6e/schema)