API Reference
The Creed Space API provides RESTful endpoints for content safety evaluation.
Base URL
https://api.creed.spaceAuthentication
All endpoints (except /health) require an API key:
bash
curl -H "X-API-Key: cs_live_..." https://api.creed.space/api/v1/safety/evaluateSee Authentication for details.
Endpoints Overview
Safety
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/safety/evaluate | Evaluate text for safety |
| GET | /api/v1/safety/metrics | Get safety metrics |
PDP (Policy Decision Point)
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/pdp/adjudicate | Get policy decision |
Constitutions
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/constitutions | List constitutions |
| GET | /api/v1/constitutions/{id} | Get constitution |
| GET | /api/v1/constitutions/merged | Get merged constitution |
API Keys
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/ssaas/keys | Create API key |
| GET | /api/v1/ssaas/keys | List API keys |
| GET | /api/v1/ssaas/keys/{id} | Get key details |
| DELETE | /api/v1/ssaas/keys/{id} | Revoke key |
| POST | /api/v1/ssaas/keys/{id}/rotate | Rotate key |
Health
| Method | Endpoint | Description |
|---|---|---|
| GET | /health | Health check (no auth) |
Response Format
All responses are JSON:
json
{
"status": "success",
"data": { ... }
}Error responses:
json
{
"error": "error_code",
"message": "Human-readable message",
"details": { ... }
}HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad request (invalid input) |
| 401 | Unauthorized (invalid/missing API key) |
| 403 | Forbidden (insufficient permissions) |
| 404 | Not found |
| 429 | Rate limited |
| 500 | Server error |
Rate Limits
Default limits per API key:
| Tier | Requests/min | Requests/day |
|---|---|---|
| Free | 10 | 100 |
| Pro | 100 | 10,000 |
| Enterprise | Custom | Custom |
Rate limit headers are included in responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1704067200