Skip to main content
PATCH
/
shared-steps
/
{sharedStepId}
curl -X PATCH "https://nunu.ai/api/v1/shared-steps/ssc_login" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 2,
    "patch": { "name": "Login Flow v2" }
  }'

{
  "id": "ssc_login",
  "project_id": "test",
  "name": "Login Flow v2",
  "version": 3,
  "is_shared": true,
  "...": "..."
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

Permission Required: project:edit-tests
Apply a partial update to a shared step collection. Like Update Test, this endpoint enforces an optimistic version check via expected_version, returning 409 if the collection has been modified since the version you fetched. The patch field is deep-merged into the current collection. Arrays (including step_order) are replaced wholesale.

​
Path Parameters

​
sharedStepId
string
required
The shared step collection ID

​
Request Body

​
expected_version
integer
required
The version returned by the most recent Get Shared Step. Must be a non-negative integer.
​
patch
object
required
Partial collection body. Cannot change the collection id or is_shared.

​
Response

Returns the updated shared step (same shape as Get Shared Step) on success. On version conflict, returns 409 with: 
{
  "error": "version conflict",
  "expected_version": 1,
  "latest_version": 2
}

curl -X PATCH "https://nunu.ai/api/v1/shared-steps/ssc_login" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 2,
    "patch": { "name": "Login Flow v2" }
  }'

{
  "id": "ssc_login",
  "project_id": "test",
  "name": "Login Flow v2",
  "version": 3,
  "is_shared": true,
  "...": "..."
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Path Parameters

​
sharedStepId
string
required

Shared step collection ID

Body

application/json
​
expected_version
integer
required
Required range: x >= 0
​
patch
object
required

Partial collection body. Cannot change id or is_shared.

Response

Shared step updated

​
id
string
​
project_id
string
​
name
string
​
version
integer
​
is_shared
boolean
​
created_at
string<date-time> | null
​
created_by
string | null
​
steps_by_key
object
​
step_order
string[]