Chat

Send a message to a specific AI Agent and receive a response. This endpoint is useful for headless integrations where you want to query your AI Agent programmatically from your own backend.

POST/chat

Request parameters

Body

agent_idstringrequired

The UUID of the agent you want to send the message to.

messagestringrequired

The user message to send to the agent.

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

successboolean

Indicates whether the request was successfully processed.

messagestring

The AI Agent’s reply to your message.

cURL

curl -X POST https://app.picobot.dev/api/chat \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "91981020-f783-4544-ad96-39857ac589cb", "message": "What is your refund policy?"}'

Node.js

fetch('https://app.picobot.dev/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    agent_id: '91981020-f783-4544-ad96-39857ac589cb',
    message: 'What is your refund policy?'
  })
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = { "Authorization": "Bearer <token>" }
response = requests.post(
  "https://app.picobot.dev/api/chat",
  headers=headers,
  json={
    "agent_id": "91981020-f783-4544-ad96-39857ac589cb",
    "message": "What is your refund policy?"
  }
)
print(response.json())

{
  "success": true,
  "message": "We offer a 30-day money-back guarantee on all plans. To request a refund, please contact our support team."
}