Skip to content
AveraAveraAvera Documentation

Endorse a transition on an item

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

Records an APPROVED or DISAPPROVED verdict against one endorsement slot. The caller must satisfy the slot’s principal, and a slot that requires a signature must carry a valid e-signature for the item. Endorsing again supersedes the caller’s earlier verdict by recency. Returns the derived status after the verdict.

Parameters

Section titled “Parameters”

Path Parameters

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

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
principalSlot
required
string
verdict
required
string
comment
string | null
signatureId
string | null format: uuid

Example generated

{
  "principalSlot": "example",
  "verdict": "example",
  "comment": "example",
  "signatureId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media type*/*
object
slots
required
Array<object>
object
slot
required
object
principal
required
object
type
required
string
id
required
string
signatureRequired
required
boolean
principalSlot
required
string
verdicts
required
Array<object>
object
id
required
string format: uuid
userId
required
string format: uuid
verdict
required
string
comment
string | null
endorsedAtSeq
required
integer format: int64
signatureId
string | null format: uuid
createdAt
required
string format: date-time
stale
required
Array<object>
object
id
required
string format: uuid
userId
required
string format: uuid
verdict
required
string
comment
string | null
endorsedAtSeq
required
integer format: int64
signatureId
string | null format: uuid
createdAt
required
string format: date-time
fillableByCaller
required
boolean
complete
required
boolean
distinctUsers
integer | null format: int32
distinctEndorsers
required
integer format: int32
complete
required
boolean
hasDisapproval
required
boolean