Ask the hosted coordinator brain an initiative-wide question
POST/api/coordinator/consult
Ask the hosted coordinator brain an initiative-wide question. Loads initiative-scoped state (in-progress tasks, recent consults, initiative profile), reasons via Claude, writes one row to coordinator.consults, and emits coordinator.consult.created via auditCritical — all in one transaction. Called by the consult_coordinator MCP tool, the pt consult CLI, and (Phase 2) the Directory chat UI.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 502
- 503
Successful response
Validation failure (malformed initiativeId, missing question, etc.)
Caller is not authenticated.
Caller is not a member of the requested initiative.
Initiative not found in the caller's tenant.
Claude API call failed or returned an unparseable response.
AI provider not configured (e.g. AI_PROVIDER=claude set without ANTHROPIC_API_KEY).