laffaire

Laffaire

Manage projects and calendar entries in a Laffaire instance via its JSON API.

In Laffaire, a project is called an Event (a named calendar group), and an individual calendar item within it is called an Entry.

Config

Before making any API call, check whether LAFFAIRE_URL and LAFFAIRE_TOKEN are already set in the environment by running a quick test curl. If a call fails due to missing variables, ask the user to provide them:

• LAFFAIRE_URL — base URL of the Laffaire instance, e.g. https://example.com
• LAFFAIRE_TOKEN — a Bearer token created from the /-/tokens page of the UI

---

Actions

Ask the user what they want to do:

1. List projects — list all their events
2. Create a project — create a new named event/calendar group
3. List entries — list calendar entries in a project
4. Add an entry — add a calendar entry to an existing project
5. Delete a project or entry

---

API Reference

All routes are under /api/v1/. All requests must include:

Authorization: Bearer <token>
Content-Type: application/json

Projects (Events)

List all projects

GET /api/v1/events

Returns an array of { id, title, description }.

Create a project

POST /api/v1/events
{ "title": "My Project", "description": "Optional description" }

Returns 201 with { id, title, description }. The id is needed to add entries.

Get a project

GET /api/v1/events/{id}

Update a project

PUT /api/v1/events/{id}
{ "title": "New Title", "description": "New description" }

Delete a project

DELETE /api/v1/events/{id}

Returns 204 No Content.

---

Entries (Calendar Items)

List entries in a project

GET /api/v1/events/{project_id}/entries

Returns an array of entry objects.

Create an entry

POST /api/v1/entries
{
  "event_id":     "<project id>",
  "subject":      "Team standup",
  "start_date":   "2026-03-10",
  "start_time":   "09:00",
  "end_date":     "2026-03-10",
  "end_time":     "09:30",
  "all_day_event": false,
  "description":  "Daily sync",
  "location":     "Zoom",
  "private":      false
}

event_id and subject are required. Returns 201 with the created entry.