Skip to main content
PATCH
Get or create a vote share token

Authorizations

Api-Token
string
header
required

Server-to-server authentication. Generate a token in the admin UI at Settings → Developers → API Access. Send the raw token in the Api-Token header — there is no Bearer prefix.

Tokens can be marked read-only at creation time, in which case the API rejects any non-GET request with 403 Forbidden.

Path Parameters

id
string
required

VoteCollection identifier

Body

application/merge-patch+json

The updated VoteCollection resource

name
string
description
string | null
owner
string<iri-reference>
Example:

"/api/v1/users/1"

votes
string<iri-reference>[]
Example:
timezone
string | null
dateStart
string<date-time> | null
dateEnd
string<date-time> | null
dateModified
string<date-time> | null
isActive
boolean
default:true
hasPreliminaryResults
boolean | null
default:false
isGeneral
boolean | null
hideVotersList
boolean | null
default:false
isAnonymous
boolean | null
default:true
unit
string<iri-reference> | null
Example:

"/api/v1/units/1"

event
string<iri-reference> | null
Example:

"/api/v1/events/1"

Response

VoteCollection resource updated