Rensei docs
API ReferenceAuthoring

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.

POST
/api/projects/{projectId}/authoring/synthesize

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

projectId*string

Request Body

application/json
  1. body
target?string
Default"workflow"
Value in"workflow""agent_card"
goal*string
Length3 <= length <= 4000
workflowId?string
agentCardId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
clarifications?

Response Body

Clarification questions or a reviewable draft candidate.

application/json
  1. response
status*string
target*string
Value in"workflow""agent_card"
questions*array<>
Example Request
curl -X POST 'https://app.rensei.ai/api/projects/string/authoring/synthesize' \  -H 'Content-Type: application/json' \  -d '{  "goal": "string"}'
Example Response
{  "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.