API Reference — Programmatic Access to Your AI Chatbot

Overview

Fetchply provides a REST API for programmatic access to your agents, conversations, knowledge sources, and webhooks. API access is available on Starter and higher plans.

Authentication

Create an API key from Dashboard → Account → API Keys and include it as a Bearer token with every request.

curl https://fetchply.com/api/v1/agents \
  -H "Authorization: Bearer fp_your_api_key"

const res = await fetch('https://fetchply.com/api/v1/agents', {
  headers: {
    Authorization: 'Bearer fp_your_api_key',
  },
});

Endpoints

Response Format

Successful responses look like:

{
  "success": true,
  "data": {}
}

Error Codes

Rate Limits

API requests are limited per key. When you hit the limit, the response includes a Retry-After header telling you how many seconds to wait.