Skip to content
POLST Developer Docs

List the caller brand's polsts (includes drafts, scheduled, archived, private).

GET
/brands/me/polsts

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
status
string
Allowed values: draft scheduled open closed archived all

Filter: draft | scheduled | open | closed | archived | all (default all).

query
string
>= 1 characters <= 300 characters

Case-insensitive substring match against polst title.

from
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

Created-at lower bound (inclusive).

to
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

Created-at upper bound (inclusive).

limit
integer
>= -9007199254740991 <= 9007199254740991

Page size (1–100).

cursor
string

Opaque cursor.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Paginated polsts.

object
data
required
Array<object>
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
slug
required
string
>= 1 characters
title
required
string
>= 1 characters
optionA
required
object
label
required
Any of:
string
imageUrl
required
Any of:
string
imageVariants
required
Array<object>
object
url
required
string
width
required
integer
> 0 <= 9007199254740991
optionB
required
object
label
required
Any of:
string
imageUrl
required
Any of:
string
imageVariants
required
Array<object>
object
url
required
string
width
required
integer
> 0 <= 9007199254740991
images
required
object
combined
required
Any of:
string
large
required
Any of:
string
medium
required
Any of:
string
small
required
Any of:
string
social
required
Any of:
string
imageVariants
required
Array<object>
object
url
required
string
width
required
integer
> 0 <= 9007199254740991
placeholder
required
Any of:
string
tallies
required
object
optionA
required
integer
<= 9007199254740991
optionB
required
integer
<= 9007199254740991
total
required
integer
<= 9007199254740991
status
required
string
Allowed values: scheduled open closed
startsAt
required
Any of:
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
endsAt
required
Any of:
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
brand
required
Any of:
object
slug
required
string
>= 1 characters
name
required
string
>= 1 characters
theme
required
object
accent
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
background
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
foreground
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
radius
required
string
Allowed values: NONE SM MD LG FULL
density
required
string
Allowed values: COMPACT COMFORTABLE
fontStack
required
string
Allowed values: SYSTEM SERIF MONO BRAND
fontBrandUrl
required
Any of:
string
<= 2048 characters
logoLightUrl
required
Any of:
string
<= 2048 characters
logoDarkUrl
required
Any of:
string
<= 2048 characters
faviconUrl
required
Any of:
string
<= 2048 characters
hideWatermark
required
boolean
customCss
required
Any of:
string
<= 4096 characters
version
required
integer
<= 9007199254740991
titleColor
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
titleSize
required
Any of:
integer
>= 10 <= 96
titleWeight
required
Any of:
integer
>= 100 <= 900
titlePlacement
required
string
Allowed values: ABOVE BELOW HIDDEN
labelColor
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
labelSize
required
Any of:
integer
>= 10 <= 72
labelPlacement
required
string
Allowed values: HEADER OVERLAID BELOW HIDDEN
labelAlign
required
string
Allowed values: LEFT CENTER
headerFill
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
orBadgeBg
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
orBadgeFg
required
Any of:
string
/^#([0-9a-f]{6}|[0-9a-f]{8})$/
orBadgeDiameter
required
Any of:
integer
>= 24 <= 96
imageRatio
required
Any of:
number
>= 0.25 <= 4
elevation
required
string
Allowed values: FLAT LIFTED
createdAt
required
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
userVote
required
Any of:
string
Allowed values: A B
isDraft
required
boolean
isPrivate
required
boolean
archivedAt
required
Any of:
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
updatedAt
required
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
tags
required
Array<string>
categories
required
Array<object>
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
slug
required
string
name
required
string
nextCursor
required
Any of:
string

401

Section titled “401 ”

Missing or invalid bearer.

403

Section titled “403 ”

Missing manage scope or no brand context.

422

Section titled “422 ”

Invalid query params.