Skip to main content
POST
Set the steps of a draft position

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Body

application/json
position_id
string<uuid>
required

The position (position_def_set.id). It must be a draft.

steps
object[]
required

The whole process in order (replaces the current one): existing steps by id, new ones without. An existing step left out is removed, unless candidates already reached it (409).

Required array length: 1 - 20 elements
dry_run
boolean
default:false

true: run the change in a transaction that is rolled back and answer the result; nothing is written.

Response

The process after the change (or as it would be, in a dry run) and what changed.

position_id
string<uuid>
required

The position (position_def_set.id).

dry_run
boolean
required

true when nothing was written.

steps
object[]
required

The process after the change, in order.

added
object[]
required

Steps added.

removed
object[]
required

Steps removed (with their AI interview or pre-screening settings).

moved
object[]
required

Kept steps whose place changed.

changed
object[]
required

Kept steps whose name or settings changed.