Send message | Fetchply

Sends a message to a chatbot agent and receives a RAG-powered reply. Non-streaming.

Authorization

bearerAuth

AuthorizationBearer <token>

API key with fp_ prefix. Generate keys in your Fetchply dashboard under Settings > API Keys.

In: header

id*string

The chatbot agent ID.

application/json

TypeScript Definitions

Use the request body type in TypeScript.

message*string

The message to send to the agent.

sessionId?string

Optional session ID to continue an existing conversation.

visitorId?string

Optional visitor identifier for tracking.

curl -X POST "https://fetchply.com/api/v1/agents/string/messages" \  -H "Content-Type: application/json" \  -d '{    "message": "string"  }'

{
  "success": true,
  "data": {
    "reply": "string",
    "sessionId": "string"
  }
}

{
  "success": false,
  "error": "Invalid or missing API key"
}

{
  "success": false,
  "error": "Resource not found"
}

{
  "success": false,
  "error": "Rate limit exceeded"
}