Generate a validated workflow or agent-card draft for explicit review.
Returns clarification questions or a deterministic reviewed candidate. This endpoint never writes, publishes, or deploys.
Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/projects/string/authoring/synthesize" \ -H "Content-Type: application/json" \ -d '{ "goal": "string" }'{
"status": "clarification_required",
"target": "workflow",
"questions": [
{
"id": "trigger",
"prompt": "string",
"reason": "string"
}
]
}Reject a proposal or apply one to an existing draft workflow.
Accept revalidates the typed candidate, vocabulary and current Cedar policy, then locks the proposal and draft workflow and commits the canvas, workflow version, proposal status and audit outbox intent transactionally. New workflows, agent-card acceptance, grouped workflows and partial acceptance are denied by default.
Read the bounded human-view knowledge-graph projection for a project.
Returns the curated, bounded human-view knowledge graph (nodes + edges with server-computed layout positions) for a project, scoped to the authenticated org. Deliberately bounded by a freshness window (default 30 days; widen with ?window=<days> or ?window=all) and top-N importance caps - the agent-facing full graph is not windowed. This is a platform-owned read projection, not a memory write surface.