API Overview

The EpicContext API gives you programmatic access to your product context. Use it to integrate with CI/CD pipelines, custom tools, or build your own workflows.

Base URL

All API requests use the following base URL:

https://epiccontext.com/api/v1

Authentication

All API requests require an API key passed in the X-API-Key header:

curl -H "X-API-Key: your-api-key" \
  https://epiccontext.com/api/v1/projects/YOUR_PROJECT_ID/blocks

See the Authentication guide for details on generating and managing API keys.

Response Format

All responses are JSON with a consistent structure:

{
  "data": { ... },
  "error": null
}

Error responses include an error message:

{
  "data": null,
  "error": "Block not found"
}

Rate Limits

The API enforces rate limits to ensure fair usage:

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1708300800

Common Operations

Public Endpoints

Some endpoints don't require authentication:

• llms.txt — GET /api/projects/{id}/llms.txt
• Markdown — GET /api/projects/{id}/markdown
• Context JSON — GET /api/projects/{id}/context

These are designed for AI agents and other tools that need read-only access to your product context.

Next Steps

• Set up API authentication
• See the full endpoint reference