API Reference

Overview

The CLAIRE Project API provides programmatic access to our AI safety framework, risk assessment tools, and monitoring systems.

Authentication

All API requests require authentication using API keys. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL

All API endpoints are relative to the base URL:

https://api.claire-project.org/v1/

Endpoints

Risk Assessment

  • GET /assessments – List risk assessments
  • POST /assessments – Create new assessment
  • GET /assessments/{id} – Get specific assessment

Safety Monitoring

  • GET /monitoring/metrics – Get safety metrics
  • GET /monitoring/alerts – Get active alerts
  • POST /monitoring/reports – Submit safety report

Framework Data

  • GET /codex – Get codex entries
  • GET /protocols – Get safety protocols
  • GET /guidelines – Get implementation guidelines

Rate Limits

API requests are limited to 1000 requests per hour per API key. Rate limit information is included in response headers.

Error Handling

The API uses standard HTTP status codes and returns error details in JSON format.

SDKs and Libraries

Official SDKs are available for Python, JavaScript, and Go. Community-contributed libraries are also available.