API Reference

Complete REST API reference for TBD Agents.

All endpoints (except /health) require an Authorization: Bearer <GITHUB_TOKEN> header.

Interactive API docs

The Swagger UI at http://localhost:8000/docs provides a fully interactive API explorer with request/response schemas.

---

Resources

• Agents — Create and manage AI agents
• Skills — Reusable instruction modules
• MCP Servers — Tool server registration and testing
• Workflows — Execution contexts, prompts, and streaming
• Knowledge — Knowledge sources and items
• Providers — Provider configuration
• Tokens — Encrypted token storage
• Guardrails — Safety policy enforcement
• Tasks — Task execution history
• Scheduled Agents — Recurring workflow prompts
• Models — Available model listing
• Import & Export — JSON bundle backup and restore

---

Authentication

All API requests require a GitHub Personal Access Token with the copilot scope:

curl -H "Authorization: Bearer ghp_your_token_here" \
  http://localhost:8000/api/agents

---

Health Check

GET /health

Returns the health status of the API. No authentication required.