Skip to main content
PUT

Authorizations

x-api-key
string
header
required

API key used to authenticate and authorise every request. Include it in the x-api-key header.

Headers

Accept
enum<string>
required

Defines the response type.

Available options:
application/vnd.Creative Force.v2.3+json,
application/vnd.Creative Force.v2.3+xml
x-api-language
enum<string>[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Available options:
all,
ar_AR,
bg_BG,
bn_IN,
ca_ES,
cs_CZ,
cy_GB,
da_DK,
de_DE,
en_GB,
en_US,
el_GR,
es_NN,
es_LA,
et_EE,
fa_NN,
fi_FI,
fr_FR,
fr_CA,
he_IL,
hi_IN,
hr_HR,
hu_HU,
hy_AM,
it_IT,
ja_JP,
ko_KR,
lt_LT,
ms_MY,
nl_NL,
nb_NO,
pl_PL,
pt_BR,
ro_RO,
ru_RU,
sk_SK,
sl_SI,
sq_AL,
sr_RS,
sv_SE,
sw_NN,
th_TH,
tr_TR,
uk_UA,
vi_VN,
zh_CN,
zh_HK

Path Parameters

entry_slug
string
required

Slug of the entry.

Pattern: ^[A-Za-z]{8}$

Body

application/json

Recusal payload identifying the judge and, optionally, the score set scope.

Shared by the recuse and unrecuse operations. When score_set is omitted the operation acts across every score set associated with the judge's assignments for the entry; otherwise it is limited to the named score set.

judge
string
required

Slug of the judge to recuse.

Must be an existing user. The recusal is recorded even when the judge has no current assignment to the entry, and prevents the judge being assigned in the future within the affected score set scope.

Pattern: ^[A-Za-z]{8}$
score_set
string

Slug of the score set to scope the recusal to.

When omitted, the recusal applies to every score set the judge has assignments under for this entry and prevents future assignment across all of them. When supplied, the scope is limited to the named score set.

Pattern: ^[A-Za-z]{8}$

Response

Assignment recused.