Skip to content

Événements de planning — CRUD

Gestion des événements de planning (planning_events) — créneaux, RDV, échéances visibles dans le calendrier d'agence.

Source : server/publicApi/routes/planning.ts:178-289. Schéma : insertPlanningEventSchema dans shared/schema.ts.

Vue d'ensemble

MéthodePathScope
GET/eventsevents:read
GET/events/:idevents:read
POST/eventsevents:write
PATCH/events/:idevents:write
DELETE/events/:idevents:delete

Webhooks émis : event.created, event.updated, event.deleted.

Pas d'événement spécifique de "complétion" pour les events (contrairement aux tasks).

Champs notables

ChampDescription
titleTitre (requis)
descriptionDescription longue
startDate, endDateDates ISO 8601 (string) — converties serveur
locationLieu (texte ou URL visio)
attendeesListe d'IDs utilisateurs (selon schéma)

agencyId et createdBy résolus serveur.


GET /events

Liste paginée triée par createdAt DESC.

json
{
  "data": [
    {
      "id": 1,
      "agencyId": 7,
      "title": "Daily team",
      "startDate": "2026-04-28T09:00:00.000Z",
      "endDate": "2026-04-28T09:15:00.000Z",
      "location": "https://meet.google.com/xyz"
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

POST /events

Body

json
{
  "title": "RDV client Acme",
  "description": "Présentation refonte",
  "startDate": "2026-05-15T14:00:00.000Z",
  "endDate": "2026-05-15T15:00:00.000Z",
  "location": "Visio - Lien dans agenda"
}

Webhook émis

event.created.


PATCH /events/:id

Mise à jour partielle. startDate et endDate re-convertis serveur si fournies.

Webhook émis

event.updated.


DELETE /events/:id

Webhook émis

event.deleted avec { "id": 42 }.

Exemple

bash
curl -X POST \
  -H "x-api-key: spk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Sync prod","startDate":"2026-05-10T10:00:00Z","endDate":"2026-05-10T10:30:00Z"}' \
  https://beta.stormeo.io/api/public/v1/events

StormeoOS API