Replace a card's eligibility
Replaces the card’s eligibility in this organisation with the list sent. Fragments missing from the list lose the card. {"fragments": []} empties the list, and the card becomes eligible everywhere in the organisation. Several cards can be eligible on the same fragment. Read the current list first.
Each fragment is addressed by its site domain and its reference; only this organisation’s fragments are accepted (a paused one too), and a card in any status can be made eligible. The list is checked entirely first, then applied at once: on any error nothing changes. The replacement is atomic within this request only; nothing protects it from a concurrent replacement.
Order of checks: the body (400, then 422 on its shape and on each domain and reference), then the card (404), then platform cards (403), then whether each fragment exists in this organisation (422).
curl -sS -X PUT "https://api.shftd2.com/v1/cards/crd_examplecard1/eligibility" \
-H "Authorization: Bearer $DS_MANAGEMENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"fragments":[{"domain":"news-site.example","ref":"/1234567/news-site/organic/politics"}]}'Authorizations
A management token: ds_mgmt_ followed by 40 lowercase hexadecimal characters, created by an owner in Settings → Management tokens. Opaque: send it as is, in the Authorization header only.
Path Parameters
The card id (crd_…), from GET /v1/cards.
Body
Send Content-Type: application/json and a JSON object of at most 262,144 bytes.
The complete list of the fragments of this organisation the card is eligible on. [] empties it: the card is then eligible everywhere in the organisation. The same fragment named twice counts once.
Show child attributes
Show child attributes
Response
The card's eligibility after the replacement.
Show child attributes
Show child attributes
curl -sS -X PUT "https://api.shftd2.com/v1/cards/crd_examplecard1/eligibility" \
-H "Authorization: Bearer $DS_MANAGEMENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"fragments":[{"domain":"news-site.example","ref":"/1234567/news-site/organic/politics"}]}'