API Documentation

All available endpoints. Some endpoints require a token obtained via the auth endpoint. If you can't automate some of your workflows via API, feel free to request more end points. They will be then implemented if they make sense for the greater good.

Public Endpoints

GET /api/status

Service health check

curl https://meetagain.org/api/status

GET /api/translations

Translation strings

curl https://meetagain.org/api/translations

GET /api/glossary

Glossary data

curl https://meetagain.org/api/glossary

Authentication

POST /api/auth/token

Generate Bearer token (email + password)

TOKEN=$(curl -s -X POST https://meetagain.org/api/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"email":"admin@example.com","password":"..."}' | jq -r .token)

DELETE /api/auth/token

Revoke current token (requires Bearer)

curl -s -X DELETE https://meetagain.org/api/auth/token \
  -H "Authorization: Bearer $TOKEN"

CMS Pages Token required

GET /api/cms/

List all CMS pages

curl https://meetagain.org/api/cms/ \
  -H "Authorization: Bearer $TOKEN"

GET /api/cms/{id}

Get full page with blocks

curl https://meetagain.org/api/cms/1 \
  -H "Authorization: Bearer $TOKEN"

POST /api/cms/

Create page — body: {slug, titles, linkNames}

curl -X POST https://meetagain.org/api/cms/ \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"slug":"my-page","titles":{"en":"My Page","de":"Meine Seite"},"linkNames":{"en":"My Page","de":"Meine Seite"}}'

PUT /api/cms/{id}

Update metadata — slug, published, titles, linkNames

curl -X PUT https://meetagain.org/api/cms/1 \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"published":true,"titles":{"en":"Updated Title"}}'

DELETE /api/cms/{id}

Delete page (not allowed if locked)

curl -X DELETE https://meetagain.org/api/cms/1 \
  -H "Authorization: Bearer $TOKEN"

CMS Blocks Token required

POST /api/cms/{id}/blocks

Add block — body: {language, type, priority, json}

curl -X POST https://meetagain.org/api/cms/1/blocks \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"language":"en","type":1,"priority":1,"json":{"text":"Hello World"}}'

PUT /api/cms/{id}/blocks/{blockId}

Update block json and/or priority

curl -X PUT https://meetagain.org/api/cms/1/blocks/5 \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"priority":2,"json":{"text":"Updated content"}}'

DELETE /api/cms/{id}/blocks/{blockId}

Delete block

curl -X DELETE https://meetagain.org/api/cms/1/blocks/5 \
  -H "Authorization: Bearer $TOKEN"