API Reference

​

Base URL

https://api.humancheck.dev

http://localhost:8000  # Local development
https://your-domain.com  # Production

​

Authentication

enable_auth: true
api_key: your-secret-key

Authorization: Bearer your-api-key-here

​

Python Example

headers = {
    "Authorization": "Bearer your-api-key-here",
    "Content-Type": "application/json"
}

​

cURL Example

curl -H "Authorization: Bearer your-api-key-here" \
     https://api.humancheck.dev/reviews

​

API Endpoints

​

Core Endpoints (Available in Both)

• POST /reviews - Create a new review
• GET /reviews - List reviews
• GET /reviews/{review_id} - Get a specific review
• POST /reviews/{review_id}/decide - Make a decision on a review
• GET /reviews/{review_id}/decision - Get the decision for a review
• POST /reviews/{review_id}/feedback - Submit feedback on a review
• POST /reviews/{review_id}/attachments - Upload attachment
• GET /reviews/{review_id}/attachments - List attachments
• GET /attachments/{id} - Get attachment
• GET /attachments/{id}/download - Download attachment
• DELETE /attachments/{id} - Delete attachment

• GET /stats - Get review statistics

• GET /health - Health check endpoint

​

Platform Endpoints (Platform Only)

• POST /organizations - Create an organization
• GET /organizations/{org_id} - Get an organization
• POST /users - Create a user
• POST /teams - Create a team
• POST /agents - Register an AI agent

• POST /routing-rules - Create a routing rule (database-backed)

• POST /evals - Create evaluation suite
• GET /audit-logs - Get audit logs
• POST /integrations/slack/oauth - OAuth connector setup
• POST /webhooks - Create webhook endpoint
• GET /webhooks - List webhooks
• POST /workflows - Create multi-user approval workflow
• GET /workflows - List approval workflows

​

OpenAPI Specification

• Swagger UI: https://api.humancheck.dev/docs
• ReDoc: https://api.humancheck.dev/redoc

​

Next Steps

• Explore Review Endpoints (Core)
• Learn about Statistics (Core)
• Set up Webhooks (Platform)
• Check out Platform Endpoints (Platform only)