Skip to content
AveraAveraAvera Documentation

Fire a lifecycle transition on an item

POST
/api/v1/items/{itemId}/transitions/{transitionId}
curl --request POST \
  --url https://app.avera.io/api/v1/items/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/transitions/example \
  --header 'Content-Type: application/json' \
  --data '{ "comment": "example", "revision": "example", "signatureId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "endorsementsSeen": true }'

The single execution path for every lifecycle move: submit, approve, reject, revise, obsolete and any customer-defined transition. The transition’s declarative requirements (comment, revision on release, signature, endorsements) are enforced here; per-transition authorization comes from the lifecycle configuration.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
itemId
required
string format: uuid
transitionId
required
string

Request Body

Section titled “Request Body”
Media typeapplication/json
object
comment
string | null
revision
string | null
signatureId
string | null format: uuid
endorsementsSeen
required
boolean

Example generated

{
  "comment": "example",
  "revision": "example",
  "signatureId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "endorsementsSeen": true
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media type*/*
object
id
required
string format: uuid
itemTypeId
required
string
canonicalId
required
string format: uuid
number
required
string
revision
string | null
seq
required
integer format: int64
status
required
string
Allowed values: DRAFT REVIEW RELEASED OBSOLETE
workflowStateId
required
string
projectId
required
string format: uuid
branchId
required
string format: uuid
createdAt
required
string format: date-time
createdBy
required
string format: uuid
modifiedAt
required
string format: date-time
modifiedBy
required
string format: uuid
attributes
object | null
wasEverReleased
boolean | null
frozenAttributeIds
Array<string> | null