Signups

Reopen a closed signup

Sets signupCloseDate to the date supplied and, if the signup is closed, makes it published again. Needed because PATCH /signups/{id} cannot change status. A date that is not in the future is refused with 400 and nothing is written. On a signup that is already published it only replaces signupCloseDate (it can move the date earlier or later) and a repeat call with the same date leaves the same end state; on a draft it sets the date and leaves the status draft. Does not touch registrations, slots or items. Also revives a signup that was cancelled (cancelling closes it), even if its participants were told it is cancelled. Notifies no participants and emits one signup.updated webhook, so a reopened signup is not announced to participants: message participants separately if they should know. The account that owns the credential must have a verified email address (returns 403 otherwise), as for publish.

post/signups/{id}/reopen

Request

  • Base URL: https://thesignup.app/api/v1
  • URL: https://thesignup.app/api/v1/signups/{id}/reopen
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

signupCloseDatestring required

The new close date, a moment in the future (a past or present one is refused with 400 and nothing is written). ISO-8601, same rules as PATCH: UTC / offset-bearing, or a naive local string read in the signup's stored timezone. Always sets the signup's signupCloseDate, replacing the old one.

Response

The signup, reopened

idstring uuid required
organizationIdstring required
slugstring required
titlestring required
status'draft' | 'published' | 'closed' required
eventDatestring date-time required

ISO-8601 UTC.

signupCloseDatestring date-time nullable required

ISO-8601 UTC. Null = signups never close until the event.

locationstring nullable required
isPrivateboolean required
createdAtstring date-time required
updatedAtstring date-time required
descriptionstring nullable required
maxParticipantsinteger nullable required

Cap on total participants. Null only on a plan with no participant ceiling (uncapped); elsewhere the cap is stored as the plan ceiling.

commitmentRequiredboolean required

When true, a participant must claim a slot or an item to sign up — attending without committing to anything is not offered.

requiresPhoneboolean required
timezonestring required

IANA timezone the organizer attached to this signup. Display surfaces should prefer this over the viewer's local zone when rendering eventDate / slot times.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440100",
  "organizationId": "org_123",
  "slug": "fall-fundraiser-a1b2",
  "title": "Fall fundraiser",
  "status": "published",
  "eventDate": "2026-09-15T17:00:00Z",
  "timezone": "America/Los_Angeles"
}

Changes

No recorded changes to this operation across all 1 revision of this API.