Rensei docs
API ReferenceProjects

Atomically set or clear project parameter overrides with revision CAS.

Parameter readiness is limited to declared values and does not assert workflow activation or execution readiness. Machine principals receive a typed writer-principal refusal.

PUT
/api/projects/{projectId}/workflow-parameters/{workflowId}

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

projectId*string
workflowId*string

Request Body

application/json
  1. body
observedDeclarationOwnerId*string
Length1 <= length
observedWorkflowKey*string
Length1 <= length
observedDeclarationDigest*string
Match^[0-9a-f]{64}$
writes*array<|>
Items1 <= items <= 128

Response Body

Current editor projection after authorization and validation.

application/json
  1. response
workflow*
binding*
parameterReadiness*string
Value in"ready""missing""invalid"
parameters*array<>
retired*array<>
Example Request
curl -X PUT 'https://app.rensei.ai/api/projects/string/workflow-parameters/string' \  -H 'Content-Type: application/json' \  -d '{  "observedDeclarationOwnerId": "string",  "observedWorkflowKey": "string",  "observedDeclarationDigest": "string",  "writes": [    {      "parameterId": "string",      "operation": "set",      "value": null,      "expectedValueVersion": 0    }  ]}'
Example Response
{  "workflow": {    "id": "string",    "name": "string"  },  "binding": {    "declarationOwnerId": "string",    "workflowKey": "string",    "declarationDigest": "string"  },  "parameterReadiness": "ready",  "parameters": [    {      "declaration": {        "id": "string",        "key": "string",        "label": "string",        "description": "string",        "type": {          "kind": "string",          "schema": {            "property1": null,            "property2": null          },          "elementType": {            "property1": null,            "property2": null          },          "members": [            {              "property1": null,              "property2": null            }          ],          "nullable": true,          "structRef": {            "id": "string",            "name": "string",            "version": 0          }        },        "required": true,        "ui": {          "control": "text",          "options": [            "string"          ],          "placeholder": "string"        }      },      "source": "project-value",      "status": "ready",      "effectiveValue": null,      "workflowDefault": null,      "valueState": "set",      "valueVersion": 0,      "validatedDeclarationDigest": "string",      "reason": "WORKFLOW_PARAMETER_REQUIRED",      "resourceAuthorityDigest": "string"    }  ],  "retired": [    {      "parameterId": "string",      "state": "set",      "valueVersion": 1,      "validatedDeclarationDigest": "string"    }  ]}

Read one workflow recipient project-parameter editor projection.

Parameter readiness is limited to declared values and does not assert workflow activation or execution readiness. Machine principals receive a typed writer-principal refusal.

Store a reviewed synthesis candidate as an isolated proposal.

Revalidates typed, base, candidate, vocabulary, policy, and proposal-version digests before appending an immutable proposal version. This route never mutates runtime workflows or agent cards.