Reference
Complete API and configuration reference for DCS integration.
API Reference
Text Content API
Public API for fetching text overrides.
- Text Content API — Fetch and manage text overrides
Configuration Files
Reference for all DCS configuration files.
- DCS Configuration —
.dcs/config.yamlschema - Pages Configuration —
.dcs/pages.yamlschema - Widget Schemas — Widget configuration schemas
Portal API
For authenticated integrations.
- Authentication — GitHub OAuth and session management
- SEO API — SEO metadata management
- Sites API — Site management endpoints
Quick Links
| Resource | Description |
|---|---|
| Text Content API | Fetch text overrides |
| DCS Config | Main configuration file |
| Pages YAML | Page definitions |
| Authentication | Auth integration |
Environment Variables
Frontend (Vite)
| Variable | Required | Description |
|---|---|---|
VITE_DCS_API | Yes | DCS API endpoint |
VITE_SITE_ID | Yes | Site identifier |
VITE_ANALYTICS_ID | No | Analytics tracking ID |
Build
| Variable | Required | Description |
|---|---|---|
NODE_ENV | No | Environment mode |
VITE_BUILD_MODE | No | Production/development |
File Structure
.dcs/
├── config.yaml # Main configuration
├── pages.yaml # Page definitions
└── widgets/ # Widget schemas
├── hero.yaml
├── features.yaml
└── testimonials.yamlStatus Codes
Success
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 204 | No Content |
| 304 | Not Modified |
Client Errors
| Code | Meaning |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | Rate Limited |
Server Errors
| Code | Meaning |
|---|---|
| 500 | Server Error |
| 503 | Service Unavailable |
