MeetAgain API

List every CMS page with its owning group and per-locale block counts

Responses

Example request

curl '/api/v1/cms/pages' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Catalogue of block types and the fields each one accepts

Responses

Example request

curl '/api/v1/cms/block-types' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Delete one block

Parameters

Responses

Example request

curl -X DELETE '/api/v1/cms/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Overlay fields onto a stored block

The payload is merged over the stored one, so a partial body only changes the fields it names.

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X PATCH '/api/v1/cms/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"Text","payload":"value"}'

Ordered blocks of one page in one locale

Parameters

Responses

Example request

curl '/api/v1/cms/pages/1/blocks?locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Append a block to a page in one locale

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/cms/pages/1/blocks' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locale":"en","type":"Text","payload":"value"}'

Move a block one position up or down within its page and locale

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/cms/blocks/1/move' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"direction":"value"}'

Store alt text for one image, keyed by locale

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X PUT '/api/v1/images/1/alt' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"alt":"value"}'

List images missing per-language alt text (keyset-paginated)

Parameters

Responses

Example request

curl '/api/v1/images/missing-alt?after_id=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Stream a downscaled preview of the original image

Parameters

Responses

Example request

curl '/api/v1/images/1/content' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List recent security incidents

Parameters

Responses

Example request

curl '/api/v1/security/incidents?limit=1&since=value' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Get a single security incident with full provider reports

Parameters

Responses

Example request

curl '/api/v1/security/incidents/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

SEO health for one property, with deltas since last pull

Parameters

Responses

Example request

curl '/api/v1/seo/status?property=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List detected SEO issues

Parameters

Responses

Example request

curl '/api/v1/seo/issues?property=1&filter=value' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List recently logged SEO actions

Parameters

Responses

Example request

curl '/api/v1/seo/actions?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Log an SEO-relevant action for later attribution

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/seo/actions' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"value","title":"value","detail":"value","git_sha":"value","issue_id":"value","occurred_at":"value"}'

List recent cron run log entries

Parameters

Responses

Example request

curl '/api/v1/logs/cron?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List email send-log entries

Parameters

Responses

Example request

curl '/api/v1/logs/sendlog?limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Get a single cron log entry

Parameters

Responses

Example request

curl '/api/v1/logs/cron/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Get a single send-log entry

Parameters

Responses

Example request

curl '/api/v1/logs/sendlog/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Sign in and receive a personal access token

Issues a new personal access token for this device and revokes the one an earlier sign-in issued for the same device name. Send it as a Bearer token on every call and sign in again on a 401.

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/auth/login' \
  -H "Content-Type: application/json" \
  -d '{"email":"value","password":"value","deviceName":"value"}'

Sign out and revoke the calling token

Responses

Example request

curl -X POST '/api/v1/auth/logout' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the members the caller has blocked

Responses

Example request

curl '/api/v1/community/blocks' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List platform members

Members the calling member may see, blocked ones excluded. A member who opted out of the directory is left out here too, exactly as on the website; their profile stays reachable by id.

Parameters

Responses

Example request

curl '/api/v1/community/members?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Block a member

Blocking drops any follow in either direction and hides the conversation from both inboxes. Repeating the call is safe.

Parameters

Responses

Example request

curl -X POST '/api/v1/community/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Unblock a member

Repeating the call is safe. Unblocking does not restore a follow that blocking removed.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/community/blocks/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Read one member profile

Parameters

Responses

Example request

curl '/api/v1/community/members/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the calling member conversations

One entry per partner, newest first. Partners blocked in either direction are left out.

Parameters

Responses

Example request

curl '/api/v1/community/conversations?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Edit a message inside the edit window

A message can be edited for ten minutes after it was sent. The website answers 403 here; this surface answers 409, because the window is a state conflict rather than an authorisation failure.

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X PATCH '/api/v1/community/messages/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Follow a member

Repeating the call is safe: it states the wanted end state rather than toggling.

Parameters

Responses

Example request

curl -X POST '/api/v1/community/members/1/follow' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Stop following a member

Repeating the call is safe.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/community/members/1/follow' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the members of one group

The same list scoped to one group. A group the caller cannot reach answers the same 404 as an unknown slug; reaching a Private or Hidden group needs a token that also carries me:read, because membership is resolved through that scope.

Parameters

Responses

Example request

curl '/api/v1/community/groups/slug/members?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Read one thread

Oldest first. This read is pure: it does not mark the thread read, unlike opening the page on the website. Call POST /api/v1/community/conversations/{userId}/read for that.

Parameters

Responses

Example request

curl '/api/v1/community/conversations/1?limit=1&offset=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Send a direct message

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/community/conversations/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Mark a thread read

Parameters

Responses

Example request

curl -X POST '/api/v1/community/conversations/1/read' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the Town Hall topics of one group

The whole forum tree of the group, depth first, as the website loads it. Not paged. A group without Town Hall, or one whose Town Hall is closed to the caller, answers 404 - the same answer as an unknown slug.

Parameters

Responses

Example request

curl '/api/v1/community/groups/slug/town-hall/topics' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Start a topic or a subtopic

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/community/groups/slug/town-hall/topics' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"value","parentId":"value"}'

List the Town Hall gallery of one group

The photos uploaded to the group's events, newest first, each with its event. Photos reported by a member are left out, as on the event page.

Parameters

Responses

Example request

curl '/api/v1/community/groups/slug/town-hall/gallery?limit=1&offset=1&locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Delete a topic

The author may delete a topic while it has no subtopics and no replies; an admin deletes it with its whole subtree.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/community/groups/slug/town-hall/topics/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Rename a topic (author or admin)

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X PATCH '/api/v1/community/groups/slug/town-hall/topics/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"value"}'

List the replies to a topic

Newest first, paged backwards like event comments: pass the previous page's nextBefore.

Parameters

Responses

Example request

curl '/api/v1/community/groups/slug/town-hall/topics/1/replies?before=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Reply to a topic

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/community/groups/slug/town-hall/topics/1/replies' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

Delete a reply (own or admin)

Parameters

Responses

Example request

curl -X DELETE '/api/v1/community/groups/slug/town-hall/topics/1/replies/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Set RSVP and guests on an event

Idempotent: sets the RSVP and the guest count in one call and answers the resulting state.

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X PUT '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"going":"value","guests":"value"}'

RSVP yes to an event

Parameters

Responses

Example request

curl -X POST '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Remove RSVP from an event

Withdrawing is never refused: a canceled event, an event that has started and a lost group membership all still let the member off the attendee list.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/events/1/rsvp' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the photos of an event

The photos of the event in every generated size. Photos reported by a member are left out, as on the event page.

Parameters

Responses

Example request

curl '/api/v1/events/1/images' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Upload an image to an event

Parameters

Request body

Content type: multipart/form-data

Responses

Example request

curl -X POST '/api/v1/events/1/images' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@/path/to/file"

List the comments on an event

Newest first, as on the event page. Page backwards by passing the previous page's nextBefore.

Parameters

Responses

Example request

curl '/api/v1/events/1/comments?before=1&limit=1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Post a comment on an event

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/events/1/comments' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"value"}'

List who is coming to an event

Who is coming, as the event page shows it to a signed-in member: the people who RSVPed with their guests, plus the organizer-maintained external count.

Parameters

Responses

Example request

curl '/api/v1/events/1/attendees' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the other dates of a recurring meeting

The upcoming visible events of the same recurring series, each with the caller's own RSVP state. An event without a series answers with itself.

Parameters

Responses

Example request

curl '/api/v1/events/1/occurrences' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Delete an event image (own upload or admin)

Parameters

Responses

Example request

curl -X DELETE '/api/v1/events/1/images/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Delete an event comment (own or admin)

Parameters

Responses

Example request

curl -X DELETE '/api/v1/events/1/comments/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List public upcoming events

Parameters

Responses

Example request

curl '/api/v1/events?locale=en&from=value&to=value&limit=1&offset=1&group=weiqi-club'

Get a single event by ID

Parameters

Responses

Example request

curl '/api/v1/events/1?locale=value'

List members of a group

Parameters

Responses

Example request

curl '/api/v1/groups/groupSlug/admin/members' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Read a group settings

Parameters

Responses

Example request

curl '/api/v1/groups/weiqi-club/admin/settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List active groups

Responses

Example request

curl '/api/v1/groups'

Get a group by slug

Parameters

Responses

Example request

curl '/api/v1/groups/groupSlug'

List a group's CMS pages

Parameters

Responses

Example request

curl '/api/v1/groups/weiqi-club/cms?language=en'

Get a CMS page metadata by group and slug

Parameters

Responses

Example request

curl '/api/v1/groups/platform/cms/about?language=value'

Get the authenticated user profile

Responses

Example request

curl '/api/v1/me' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Edit the authenticated member profile

Only the fields present in the body change. The name follows the website rule: a name already stored above the cap keeps working, but a change has to fit it.

Request body

Content type: application/json

Responses

Example request

curl -X PATCH '/api/v1/me' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"value","bio":"value","locale":"value","public":"value"}'

List the authenticated user upcoming RSVPs

Parameters

Responses

Example request

curl '/api/v1/me/rsvps?locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Replace the authenticated member avatar

Replaces the member avatar. The previous picture stays in the member own gallery, as on the website.

Request body

Content type: multipart/form-data

Responses

Example request

curl -X POST '/api/v1/me/avatar' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@/path/to/file"

List the groups of the authenticated member

Every group the member belongs to or has asked to join, including the ones that blocked them, each with the role and the membership status.

Responses

Example request

curl '/api/v1/me/groups' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the upcoming meetings of the authenticated member

The upcoming events of the member's groups plus the visible upcoming events they RSVPed to elsewhere, canceled ones included and flagged.

Parameters

Responses

Example request

curl '/api/v1/me/events?from=value&limit=1&offset=1&locale=en' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Issue the notification signal token for this device

Issues a second token for the calling app device that can only read GET /api/v1/signal, valid for 90 days. Asking again replaces it, and revoking the device app token revokes it too.

Responses

Example request

curl -X POST '/api/v1/me/signal-token' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the authenticated member notifications

The website navbar bell, as data. Every item is computed live from the same providers the website uses; nothing is stored, so there is no read state, no history and no cursor. Labels come back in the request locale.

Responses

Example request

curl '/api/v1/me/notifications' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the registered push devices

Also carries the VAPID public key a client needs before it can subscribe, and whether push is configured on this platform at all.

Responses

Example request

curl '/api/v1/me/push-subscriptions' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Register a push device

Registers a Web Push endpoint against the calling token, so revoking the device at /profile/access-tokens stops its pings. Re-posting a known endpoint moves it to the calling device and answers 200.

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/me/push-subscriptions' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"value","p256dh":"value","auth":"value","transport":"value"}'

Read the authenticated member notification preferences

The same master switch and six toggles the member edits at /profile/config.

Responses

Example request

curl '/api/v1/me/notification-settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Edit the authenticated member notification preferences

Only the keys present in the body change. Writes through the same service as the website, so a change here shows up at /profile/config.

Request body

Content type: application/json

Responses

Example request

curl -X PATCH '/api/v1/me/notification-settings' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Remove a push device

Removes one registered device. Another member row answers 404 rather than 403, so the endpoint does not confirm that an id exists.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/me/push-subscriptions/1' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

List the open group invitations

Invitations addressed to the calling member, minus those hidden by a block in either direction.

Responses

Example request

curl '/api/v1/memberships/invitations' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Join a listed group, or ask to

Only a group listed on the groups portal can be joined here. A Hidden group is joined on its own domain and a Private group by invitation, so both answer group_not_joinable. When the group requires approval the membership comes back pending.

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/memberships/groups/slug' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platformMailConsent":"value"}'

Leave a group

The same rules the website applies: the last owner cannot leave, a blocked member cannot, and the platform group can only be left once it is no longer needed for another membership.

Parameters

Responses

Example request

curl -X DELETE '/api/v1/memberships/groups/slug' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Accept a group invitation

Accepting settles the membership at the invited role. While the member still has to join the platform group, this answers 409 platform_crossing_required; retry with platformMailConsent to answer that question first.

Parameters

Request body

Content type: application/json

Responses

Example request

curl -X POST '/api/v1/memberships/invitations/1/accept' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platformMailConsent":"value"}'

Decline a group invitation

Parameters

Responses

Example request

curl -X POST '/api/v1/memberships/invitations/1/decline' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Whether anything changed for the member

An opaque value that changes when the bell changes, when an event the member said yes to is cancelled, moved in time or to another place, and when its reminder falls due. It reveals nothing else, so a token that can only read this section is safe to keep where the app cannot protect it.

Responses

Example request

curl '/api/v1/signal' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Health check endpoint

Responses

Example request

curl '/api/status'