Manage one provider workflow

PUT/business-pipelines/{pipeline_slug}/stages/

Read first. Send the complete desired stage list and that workflow's expected_revision. Existing categories cannot change. Follow the stage creation fields in this resource schema. Omit a stage only when its deletion_blocker is null. Records are never moved by a configuration edit. Reuse Idempotency-Key only for an identical retry.

Parameters

Name	Location	Type	Required
`pipeline_slug` View parameter schema	path	string	Yes
`Idempotency-Key` View parameter schema	header	string	Yes

Request body

Send a body that matches the published schema.

View request schema

Example request

curl --request PUT \
  --url "https://api.levr.ai/v1/business-pipelines/$PIPELINE_SLUG/stages/" \
  --header "Authorization: Bearer $LEVR_API_KEY" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data "@request.json"

curl --request PUT \
  --url "https://api.levr.ai/v1/business-pipelines/$PIPELINE_SLUG/stages/" \
  --header "Authorization: Bearer $LEVR_API_KEY" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "expected_revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "stages": [
    {
      "id": "bstg_a1b2c3d4e5f6g7h8",
      "name": "Preparing application",
      "category_key": "action_required"
    },
    {
      "copy_from_id": "bstg_a1b2c3d4e5f6g7h8",
      "name": "Waiting for documents",
      "category_key": "action_required"
    }
  ]
}'

Responses

Status	What it means
`200`	Current provider workflows View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`400`	Correct the request fields and try again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`401`	Provide a valid API key and try again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`403`	This API key does not allow the requested action. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`404`	The requested resource was not found or is not available to this API key. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`409`	The request conflicts with the resource's current state. Refresh it before trying again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`429`	Too many requests were sent. Wait before trying again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`500`	Levr could not complete the request. Keep the request ID and retry when safe. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response

Copy instructions to your AI agent

Request an integration