Rensei docs
API ReferenceProjects

Edit the fields of the project- or workflow-scope stage row for a key (project admin).

Edit the fields of the project- or workflow-scope stage row for a key (project admin). - Rensei REST API operation reference.

PATCH
/api/projects/{projectId}/stages/{key}

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

The project id.

key*string

The stage key (lowercase kebab-case).

Match^[a-z0-9]+(-[a-z0-9]+)*$
Length1 <= length <= 64

Request Body

application/json
  1. body
role?string

A define only; an override never sets a role.

Value in"hold""intake""inflight""review""rework""done""closed"
name?|

Display name; required on a define.

Length1 <= length <= 200
description?|
Lengthlength <= 2000
disabled?|

true hides an inherited stage; null inherits.

modelSelection?|||||

The stage default; a bare inherit is stored as null.

outcomes?|

Targets must be keys of the effective set of this scope, or stay.

retry?|null
policies?|null
workflowId?string

Write the workflow-scope row of this workflow (one of the project's).

Length1 <= length

Response Body

The updated stage row.

application/json
  1. response
stage*
Example Request
curl -X PATCH 'https://app.rensei.ai/api/projects/string/stages/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "stage": {    "id": "string",    "scope": "system",    "scopeId": "string",    "key": "string",    "kind": "define",    "role": "hold",    "name": "string",    "description": "string",    "disabled": true,    "modelSelection": {      "mode": "inherit",      "effort": "low"    },    "outcomes": {      "start": {        "target": "string"      },      "success": {        "target": "stay"      },      "failure": {        "target": "stay"      },      "blocked": {        "target": "stay"      },      "close": {        "target": "stay"      }    },    "retry": {      "retries": 0,      "backoffSeconds": 0    },    "policies": {      "version": 1    },    "createdAt": "string",    "updatedAt": "string"  }}

Create a stage define or override at project or workflow scope (project admin).

Create a stage define or override at project or workflow scope (project admin). - Rensei REST API operation reference.

Archive the project- or workflow-scope stage row for a key (project admin).

Archive the project- or workflow-scope stage row for a key (project admin). - Rensei REST API operation reference.