AI
Agents

Chat with a Mammoth agent

Starts an agent turn and returns its ids at once; the turn's events are read from the turn events endpoint. A retry with the same request_key returns the same turn.

post/agents/chat

Request

  • Base URL: https://app.mammoth.io/api/v2
  • URL: https://app.mammoth.io/api/v2/agents/chat
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-KEY and API key in header X-API-SECRET and API key in header X-WORKSPACE-ID

Request body

request_keystring required
agent_keystring nullable
session_idstring nullable
messagestring
client_contextobject
is_system_eventboolean
credentialsobject nullable
selected_columnsstring[] nullable

Response

Request accepted, processing continues off-line

session_idstring required
turn_idstring required

Changes

No recorded changes to this operation across all 4 revisions of this API.