Roundtable mark
Crucible
API Reference

Crucible API Reference

Integrate Crucible into your workflow with our REST API. Create sessions, manage Agents, and retrieve artifacts programmatically.

Base URL

https://api.roundtablelabs.ai/api
text

All API endpoints are prefixed with /api.

Authentication

Crucible uses JWT (JSON Web Tokens) for authentication. Most endpoints require authentication.

See the Authentication guide for details.

Main Endpoints

Sessions

Create, manage, and monitor debate sessions.

  • POST /sessions - Create a new session
  • GET /sessions - List your sessions
  • GET /sessions/{id} - Get session details
  • POST /sessions/{id}/start - Start a session
  • POST /sessions/{id}/abort - Abort a running session
  • DELETE /sessions/{id} - Delete a session

View detailed Sessions API →

Agents

Manage Agents (formerly Knights) for your sessions.

  • GET /knights/official - List official Agents
  • GET /knights/mine - List your Agents
  • POST /knights - Create a new Agent
  • PUT /knights/{id} - Update an Agent
  • DELETE /knights/{id} - Delete an Agent

View detailed Agents API →

Marketplace

Browse and install Agents from the Marketplace.

  • GET /marketplace/knights - List Marketplace Agents
  • GET /marketplace/telemetry - Get Marketplace statistics

View detailed Marketplace API →

Artifacts

Retrieve Decision Briefs and Meeting Minutes.

  • GET /sessions/{id}/artifacts/json - Get artifacts as JSON
  • GET /sessions/{id}/artifacts/download - Download artifacts
  • POST /sessions/{id}/artifacts/pdf - Generate PDF

WebSocket Events

Stream real-time session events via WebSocket.

  • WS /sessions/{id}/events - Stream session events

View WebSocket documentation →

Rate Limits

API rate limits vary by plan:

  • Pay per Session: 100 requests per hour
  • Pro: 1,000 requests per hour
  • Enterprise: Custom limits

Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Error Handling

The API uses standard HTTP status codes:

400 - Bad Request
401 - Unauthorized
403 - Forbidden
404 - Not Found
429 - Too Many Requests
500 - Internal Server Error

Next Steps

Authentication

Learn how to authenticate API requests

Sessions API

Detailed Sessions endpoint documentation

Code Examples

See API usage examples

WebSocket Events

Stream real-time session events