Config Service API Reference
Complete endpoint reference for the Config Service (port 8888). All endpoints require JWT authentication via the Authorization: Bearer :token header.
Configuration Management (/api/v1/configs)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/configs | Create a configuration entry |
GET | /api/v1/configs/:id | Get config by ID |
GET | /api/v1/configs/tenant/:tenantId/key/:configKey | Get config by tenant and key |
GET | /api/v1/configs/tenant/:tenantId/key/:configKey/resolve | Hierarchical resolution |
GET | /api/v1/configs/tenant/:tenantId/value/:configKey | Get value only |
GET | /api/v1/configs/tenant/:tenantId | List tenant configs (paginated) |
GET | /api/v1/configs/tenant/:tenantId/category/:category | Get by category |
GET | /api/v1/configs/tenant/:tenantId/search | Search by key pattern |
GET | /api/v1/configs/global | Get global configs |
PUT | /api/v1/configs/:id | Update config |
DELETE | /api/v1/configs/:id | Delete config |
GET | /api/v1/configs/:id/versions | Get version history |
GET | /api/v1/configs/:id/versions/:versionNumber | Get specific version |
POST | /api/v1/configs/:id/rollback | Rollback to version |
POST | /api/v1/configs/tenant/:tenantId/import | Bulk import |
GET | /api/v1/configs/tenant/:tenantId/export | Export all configs |
Feature Flags (/api/v1/feature-flags)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/feature-flags | Create a feature flag |
GET | /api/v1/feature-flags/:id | Get flag by ID |
GET | /api/v1/feature-flags/tenant/:tenantId/key/:flagKey | Get flag by key |
GET | /api/v1/feature-flags/tenant/:tenantId/key/:flagKey/enabled | Check if enabled |
GET | /api/v1/feature-flags/tenant/:tenantId/key/:flagKey/evaluate | Evaluate for user |
GET | /api/v1/feature-flags/tenant/:tenantId | List flags (paginated) |
GET | /api/v1/feature-flags/tenant/:tenantId/enabled | List enabled flags |
GET | /api/v1/feature-flags/tenant/:tenantId/tag/:tag | List flags by tag |
GET | /api/v1/feature-flags/global | List global flags |
PUT | /api/v1/feature-flags/:id | Update flag |
DELETE | /api/v1/feature-flags/:id | Delete flag |
POST | /api/v1/feature-flags/:id/enable | Enable flag |
POST | /api/v1/feature-flags/:id/disable | Disable flag |
PUT | /api/v1/feature-flags/:id/rollout | Update rollout percentage |
POST | /api/v1/feature-flags/:id/users | Add allowed users |
DELETE | /api/v1/feature-flags/:id/users | Remove allowed users |
POST | /api/v1/feature-flags/tenant/:tenantId/evaluate-batch | Batch evaluate |
A/B Testing (/api/v1/experiments)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/experiments | Create experiment |
PUT | /api/v1/experiments/:experimentId | Update experiment |
GET | /api/v1/experiments/:experimentId | Get experiment |
GET | /api/v1/experiments/key/:experimentKey | Get by key |
GET | /api/v1/experiments | List experiments |
GET | /api/v1/experiments/status/:status | List by status |
POST | /api/v1/experiments/:experimentId/start | Start experiment |
POST | /api/v1/experiments/:experimentId/pause | Pause experiment |
POST | /api/v1/experiments/:experimentId/complete | Complete experiment |
POST | /api/v1/experiments/:experimentId/archive | Archive experiment |
POST | /api/v1/experiments/:experimentId/assign | Assign variant |
GET | /api/v1/experiments/:experimentId/assignment/:userId | Get assignment |
POST | /api/v1/experiments/:experimentId/track/impression | Track impression |
POST | /api/v1/experiments/:experimentId/track/conversion | Track conversion |
POST | /api/v1/experiments/:experimentId/track/event | Track custom event |
GET | /api/v1/experiments/:experimentId/results | Get results |
POST | /api/v1/experiments/:experimentId/results/recalculate | Recalculate |
Targeting (/api/v1/targeting)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/targeting/evaluate | Evaluate with context |
POST | /api/v1/targeting/evaluate/:flagKey | Evaluate single flag |
GET | /api/v1/targeting/evaluate/:flagKey | Quick evaluate |
POST | /api/v1/targeting/flags/:flagId/rules | Add targeting rule |
PUT | /api/v1/targeting/flags/:flagId/rules/:ruleId | Update rule |
DELETE | /api/v1/targeting/flags/:flagId/rules/:ruleId | Delete rule |
PUT | /api/v1/targeting/flags/:flagId/rules/reorder | Reorder rules |
GET | /api/v1/targeting/attributes | Available attributes |
GET | /api/v1/targeting/operators | Available operators |
Secrets (/api/v1/config/secrets)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/config/secrets | Create secret |
GET | /api/v1/config/secrets/value | Get secret value |
GET | /api/v1/config/secrets | List secrets (metadata) |
PUT | /api/v1/config/secrets/:secretId | Update secret |
POST | /api/v1/config/secrets/:secretId/rotate | Rotate secret |
DELETE | /api/v1/config/secrets/:secretId | Delete secret |
GET | /api/v1/config/secrets/service/:serviceName | Service secrets |
GET | /api/v1/config/secrets/rotation/pending | Pending rotations |
GET | /api/v1/config/secrets/expiring | Expiring secrets |
POST | /api/v1/config/secrets/encryption-key/rotate | Rotate encryption key |
GET | /api/v1/config/secrets/stats | Secret statistics |
Approvals (/api/v1/config/approvals)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/config/approvals/config/:configId | Request config change |
POST | /api/v1/config/approvals/flags/:flagId/toggle | Request flag toggle |
GET | /api/v1/config/approvals/pending | List pending |
GET | /api/v1/config/approvals/my-requests | List my requests |
GET | /api/v1/config/approvals/:requestId | Get request |
POST | /api/v1/config/approvals/:requestId/approve | Approve |
POST | /api/v1/config/approvals/:requestId/reject | Reject |
POST | /api/v1/config/approvals/:requestId/request-changes | Request changes |
DELETE | /api/v1/config/approvals/:requestId | Cancel |
POST | /api/v1/config/approvals/:requestId/schedule | Schedule apply |
Promotions (/api/v1/config/promotions)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/config/promotions | Create promotion |
GET | /api/v1/config/promotions | List promotions |
GET | /api/v1/config/promotions/:promotionId | Get promotion |
POST | /api/v1/config/promotions/:promotionId/validate | Validate |
POST | /api/v1/config/promotions/:promotionId/approve | Approve |
POST | /api/v1/config/promotions/:promotionId/execute | Execute |
POST | /api/v1/config/promotions/:promotionId/schedule | Schedule |
POST | /api/v1/config/promotions/:promotionId/rollback | Rollback |
DELETE | /api/v1/config/promotions/:promotionId | Cancel |
GET | /api/v1/config/promotions/diff | Environment diff |
Bulk Operations (/api/v1/config/bulk)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/config/bulk/export | Export configs |
POST | /api/v1/config/bulk/import | Import from file |
POST | /api/v1/config/bulk/import/inline | Import inline |
POST | /api/v1/config/bulk/validate | Validate import |
POST | /api/v1/config/bulk/compare | Compare import |
GET | /api/v1/config/bulk/template | Get template |
Schedules (/api/v1/schedules)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/schedules/one-time | Create one-time |
POST | /api/v1/schedules/recurring | Create recurring |
POST | /api/v1/schedules/window | Create window |
PUT | /api/v1/schedules/:scheduleId | Update schedule |
GET | /api/v1/schedules/:scheduleId | Get schedule |
GET | /api/v1/schedules | List schedules |
GET | /api/v1/schedules/flag/:flagId | Schedules for flag |
GET | /api/v1/schedules/flag/:flagId/active | Active schedules |
GET | /api/v1/schedules/upcoming | Upcoming schedules |
POST | /api/v1/schedules/:scheduleId/pause | Pause |
POST | /api/v1/schedules/:scheduleId/resume | Resume |
POST | /api/v1/schedules/:scheduleId/cancel | Cancel |
POST | /api/v1/schedules/:scheduleId/execute | Execute now |
GET | /api/v1/schedules/:scheduleId/executions | Execution history |
Config Audit (/api/v1/config/audit)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/config/audit | Tenant history |
GET | /api/v1/config/audit/config/{configId} | Config history |
GET | /api/v1/config/audit/flags/{flagId} | Flag history |
GET | /api/v1/config/audit/secrets | Secret audit |
GET | /api/v1/config/audit/user/{userId} | User history |
GET | /api/v1/config/audit/range | Time range query |
GET | /api/v1/config/audit/search | Search by key |
GET | /api/v1/config/audit/versions/{targetId} | Version history |
GET | /api/v1/config/audit/versions/{targetId}/{version} | Specific version |
GET | /api/v1/config/audit/versions/{targetId}/diff | Version diff |
GET | /api/v1/config/audit/correlation/{correlationId} | By correlation |
GET | /api/v1/config/audit/request/{requestId} | By change request |
GET | /api/v1/config/audit/stats | Statistics |
Cache (/api/v1/cache)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/cache/stats | Cache statistics |
POST | /api/v1/cache/stats/reset | Reset statistics |
DELETE | /api/v1/cache/all | Clear all caches |
DELETE | /api/v1/cache/tenant/{tenantId}/configs | Clear tenant configs |
DELETE | /api/v1/cache/tenant/{tenantId}/flags | Clear tenant flags |
DELETE | /api/v1/cache/config/{tenantId}/{configKey} | Invalidate config |
DELETE | /api/v1/cache/flag/{tenantId}/{flagKey} | Invalidate flag |