API Reference

AgentForge REST API

Integrate AI agents into your applications with our REST API. Simple authentication, JSON responses, streaming supported.

Base URL:https://agentforge.solutions/api

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API keys from the Settings → API Keys section of the dashboard.

# Authentication with Bearer Token

Authorization: Bearer sk-af-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Or as query parameter (not recommended)

GET /api/agents?api_key=sk-af-xxxxx

⚠️ Never expose API keys in frontend code or public repositories. Always use server-side environment variables.

Available endpoints

GET/api/agentsList account agents

POST/api/agentsCreate a new agent

GET/api/agents/{id}Get the details of a specific agent

PUT/api/agents/{id}Update an agent's configuration

DELETE/api/agents/{id}Delete an agent and all its data

POST/api/agents/{id}/chatSend a message to the agent (streaming)

GET/api/marketplaceList marketplace agents

POST/api/widget/{slug}Public endpoint for embeddable widget

Code examples

curl -X POST https://agentforge.solutions/api/agents/{id}/chat \
  -H "Authorization: Bearer sk-af-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello, I need some help",
    "session_id": "user-123",
    "stream": true
  }'

Rate Limits

Rate limits vary by plan. Requests exceeding the limit receive a 429 response. The limit resets every minute.

Plan

Rate Limit

Burst Limit

Starter

100 req/min

200 req/min

Growth

500 req/min

1000 req/min

Scale

2000 req/min

5000 req/min

Error codes

400

Bad RequestMissing or invalid request parameters

401

UnauthorizedMissing, invalid or expired API key

403

ForbiddenYou don't have permission to access this resource

404

Not FoundThe requested resource does not exist

429

Too Many RequestsYou have exceeded your plan's rate limit

500

Internal Server ErrorInternal server error, please try again shortly

Ready to start with the API?

Get your API key →