Skip to main content
POST
Promote, merge or reject a candidate

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

candidate_id
string<uuid>
required

The candidate's ID.

Body

application/json

What a steward does with a candidate.

action
enum<string>
required
Available options:
promote,
merge,
reject
as_type
enum<string>
default:text
Available options:
text,
constraint
title
string | null
Maximum string length: 200
text
string | null

Edited wording; defaults to the proposal.

Maximum string length: 8000
item_id
string | null

merge: the item to append to; promote: a new id.

reason
string | null
Maximum string length: 2000
accept_sensitivity
boolean
default:false

Accept a candidate that would raise the pack's sensitivity.

Response

Successful Response

The decided candidate, and the draft version it went into.

candidate
CandidateView · object
required

A proposed fact awaiting a steward.

draft_version_id
string<uuid> | null
draft_version
string | null