SynqDocs
Management APIDiscord servers

List a Discord server's role windows

Every gated role of the server whose gate gives those already holding it time to verify (`existing_members: verify`), each with its announced window: its settings (Synq's defaults for one never saved), its state, every reminder with when it goes, and the counts of the role's holders. Needs `org.integrations.view`.

GET/v1/orgs/{org}/discord-servers/{server}/windows

Every gated role of the server whose gate gives those already holding it time to verify (existing_members: verify), each with its announced window: its settings (Synq's defaults for one never saved), its state, every reminder with when it goes, and the counts of the role's holders. Needs org.integrations.view.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$
server*string

The Discord server's id

Match^dsv_[0-9a-hjkmnp-tv-z]{26}$

Query Parameters

limit?integer

At most this many items, 200 at the most.

Range1 <= value <= 200
Default50
cursor?string

The previous page's next_cursor, for the page after it.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/discord-servers/dsv_01h455vb4pex5vsknk084sn02q/windows" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "data": [    {      "server": "string",      "role": "string",      "role_name": "string",      "state": "draft",      "notice_days": 0,      "deadline_time": "string",      "time_zone": "string",      "quiet_hours": {        "from": "string",        "to": "string"      },      "name_unverified": true,      "headline": "string",      "verify_channel": "string",      "listing": true,      "starts_at": "2026-10-21T12:00:00.000Z",      "ends_at": "2026-10-21T12:00:00.000Z",      "paused_at": "2026-10-21T12:00:00.000Z",      "extended_at": "2026-10-21T12:00:00.000Z",      "closed_at": "2026-10-21T12:00:00.000Z",      "schedule": [        {          "reminder": "m1",          "kind": "monthly",          "at": "2026-10-21T12:00:00.000Z",          "names": true,          "done": true        }      ],      "counts": {        "holders": 0,        "verified": 0,        "to_verify": 0,        "settled": 0      },      "problem": "members_unknown",      "problem_detail": "string",      "announce_queued_at": "2026-10-21T12:00:00.000Z",      "announce_failure": "string"    }  ],  "next_cursor": "string"}