API Reference

https://api.prismcontext.com/v1

curl https://api.prismcontext.com/v1/rules \
  -H "Authorization: Bearer YOUR_API_KEY"

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1710936000

GET /rules

curl "https://api.prismcontext.com/v1/rules?category=styling&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "rule_abc123",
      "title": "Color Palette",
      "category": "styling",
      "content": "# Color Palette\n\n...",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-03-20T14:45:00Z"
    }
  ],
  "pagination": {
    "total": 45,
    "limit": 10,
    "offset": 0
  }
}

GET /rules/{rule_id}

curl https://api.prismcontext.com/v1/rules/rule_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "rule_abc123",
  "title": "Color Palette",
  "category": "styling",
  "content": "# Color Palette\n\n## Primary Colors\n...",
  "project_id": "proj_xyz789",
  "tags": ["design", "colors"],
  "metadata": {
    "author": "user@example.com",
    "version": "1.2.0"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-20T14:45:00Z"
}

POST /rules

{
  "title": "Form Validation",
  "category": "architecture",
  "content": "# Form Validation\n\nAlways use Zod...",
  "project_id": "proj_xyz789",
  "tags": ["forms", "validation"]
}

curl -X POST https://api.prismcontext.com/v1/rules \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Form Validation",
    "category": "architecture",
    "content": "# Form Validation\n\nAlways use Zod..."
  }'

{
  "id": "rule_new456",
  "title": "Form Validation",
  "category": "architecture",
  "created_at": "2024-03-21T09:00:00Z"
}

PATCH /rules/{rule_id}

{
  "title": "Updated Title",
  "content": "# Updated Content..."
}

curl -X PATCH https://api.prismcontext.com/v1/rules/rule_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "# Updated Content..."}'

DELETE /rules/{rule_id}

curl -X DELETE https://api.prismcontext.com/v1/rules/rule_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /search

{
  "query": "How should I handle API errors?",
  "limit": 5,
  "threshold": 0.7,
  "categories": ["architecture", "testing"],
  "project_id": "proj_xyz789"
}

curl -X POST https://api.prismcontext.com/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "error handling patterns", "limit": 5}'

{
  "results": [
    {
      "rule_id": "rule_abc123",
      "title": "Error Handling",
      "category": "architecture",
      "score": 0.92,
      "snippet": "...always use try/catch blocks and log errors..."
    }
  ],
  "total": 3,
  "query_time_ms": 45
}

GET /projects

GET /projects/{project_id}

POST /projects

{
  "name": "My Web App",
  "description": "Main marketing website"
}

PATCH /projects/{project_id}

DELETE /projects/{project_id}

GET /brands

GET /brands/{brand_id}

{
  "id": "brand_abc123",
  "name": "Acme Corp",
  "version": "2.0.0",
  "colors": {
    "primary": { "value": "#06b6d4" },
    "secondary": { "value": "#8b5cf6" }
  },
  "typography": {
    "fontFamily": {
      "sans": "Inter",
      "mono": "JetBrains Mono"
    }
  }
}

POST /brands

PATCH /brands/{brand_id}

DELETE /brands/{brand_id}

POST /videos

curl -X POST https://api.prismcontext.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@video.mp4" \
  -F "title=Design System Tour" \
  -F "project_id=proj_xyz789"

{
  "id": "vid_abc123",
  "status": "processing",
  "progress": 0,
  "estimated_time": "3 minutes"
}

GET /videos/{video_id}

{
  "id": "vid_abc123",
  "title": "Design System Tour",
  "status": "completed",
  "duration": 245,
  "transcript_url": "https://...",
  "rules_generated": 7
}

GET /videos

DELETE /videos/{video_id}

GET /webhooks

POST /webhooks

{
  "url": "https://your-app.com/webhook",
  "events": ["rule.created", "rule.updated", "rule.deleted"]
}

{
  "event": "rule.updated",
  "timestamp": "2024-03-21T10:30:00Z",
  "data": {
    "rule_id": "rule_abc123",
    "title": "Updated Rule"
  }
}

DELETE /webhooks/{webhook_id}

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request body",
    "details": [
      { "field": "title", "message": "Title is required" }
    ]
  }
}

npm install @prism/sdk

import { PrismClient } from '@prism/sdk';
 
const prism = new PrismClient({ apiKey: 'YOUR_API_KEY' });
 
// Get rules
const rules = await prism.rules.list({ category: 'styling' });
 
// Search
const results = await prism.search('error handling');
 
// Create rule
const rule = await prism.rules.create({
  title: 'New Rule',
  content: '# Content...'
});

pip install prism-sdk

from prism import PrismClient
 
prism = PrismClient(api_key='YOUR_API_KEY')
 
# Get rules
rules = prism.rules.list(category='styling')
 
# Search
results = prism.search('error handling')

curl https://api.prismcontext.com/v1/openapi.json -o openapi.json