API overview

REST is Lucim’s canonical programmatic contract. The CLI, CI gate, console adapters, and MCP server reuse the same service layer rather than implementing separate business rules.

Base URL

Set the API base URL for your deployment:

export LUCIM_API_URL="https://your-lucim-api.example"

Local development uses http://localhost:8000.

Core endpoints

Method	Endpoint	Scope	Purpose
`GET`	`/v1/changes`	`read`	List verified changes for watched entities
`GET`	`/v1/entities/{entity_id}/mcp-profile`	`read`	Read the current MCP server surface
`GET`	`/v1/entities/{entity_id}/sdk-releases`	`read`	List SDK release deltas
`GET`	`/v1/replay-results`	`read`	List replay runs and divergences
`GET`	`/v1/signals/{signal_id}/evidence`	`read`	Read a signal’s evidence trail
`POST`	`/v1/watches`	`write`	Create a watch or direct monitor
`PATCH`	`/v1/watches/{watch_id}`	`write`	Update watch configuration
`POST`	`/v1/signals/{signal_id}/acknowledge`	`write`	Acknowledge a visible signal
`GET`	`/v1/ci/gate`	`read`	Check unacknowledged breaking signals
`POST`	`/v1/replay-probes/{probe_id}/run`	`write`	Queue a replay run

Repository configuration, dependency evidence, and sandbox endpoints extend /v1 behind their own capability gates. Higher-stage exposure and fleet routes are mounted only at the required product stage.

All identifiers are tenant-scoped by the authenticated API key. Requests never accept a client-selected team_id for authorization.

Essentials

REST v1

API overview

Base URL

Core endpoints

​Base URL

​Core endpoints

Base URL

Core endpoints