SynqDocs
Management APIRoles

Move a Discord role's deadline later

Moves the deadline to `ends_at`, which must be later than it is (it never moves earlier once announced), at most 365 days away and outside quiet hours. Synq posts one message in the Verify channel saying so, pinging the role, and edits the countdown; those still to verify get the new date. Recorded as `discord_role.window_extended`. Needs `org.integrations.edit`.

POST/v1/orgs/{org}/discord-servers/{server}/roles/{role}/window/extend

Moves the deadline to ends_at, which must be later than it is (it never moves earlier once announced), at most 365 days away and outside quiet hours. Synq posts one message in the Verify channel saying so, pinging the role, and edits the countdown; those still to verify get the new date. Recorded as discord_role.window_extended. Needs org.integrations.edit.

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}$
role*string

The gated role's Discord id

Match^[1-9][0-9]{16,19}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/discord-servers/dsv_01h455vb4pex5vsknk084sn02q/roles/1187390245566009876/window/extend" \  -H "Authorization: Bearer $SYNQ_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "ends_at": "2027-12-07T23:00:00Z"  }'
{  "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"}