meet and rockDeveloper Docs

Event Management API

Use the Event Management API to create, list, update, and delete events, manage participants, and configure repetition rules for recurring events.

Base URL
https://api.meetandrock.com/v1/dev
Authentication

Send your secret API key as a Bearer token in the Authorization header:Authorization: Bearer YOUR_API_KEY

Event Management

Core endpoints for listing, creating, retrieving, updating, and deleting events.

List Events

Retrieve all events for the project, including occurrence data and participants.

GEThttps://api.meetandrock.com/v1/dev/events
List events

Retrieve all events for the project.

curl -X GET "https://api.meetandrock.com/v1/dev/events" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Event

Create a new event with title, description, time range, repetition rule, and optional calendar, task, and members.

Repetition options: only today, every day, every working day, every weekend, every monday, every tuesday, every wednesday, every thursday, every friday, every saturday, every sunday.

POSThttps://api.meetandrock.com/v1/dev/events
Create event

Create a new event with optional repetition and participants.

curl -X POST "https://api.meetandrock.com/v1/dev/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team Meeting",
    "description": "Weekly team sync",
    "start_date": "2024-01-15T10:00:00Z",
    "end_date": "2024-01-15T11:00:00Z",
    "event_type": "meeting",
    "repetition": "every monday",
    "calendar_id": "uuid",
    "task_id": "uuid",
    "members": ["uuid", "uuid"]
  }'

Get Event

Retrieve a single event by its ID.

GEThttps://api.meetandrock.com/v1/dev/events/:eventId
Retrieve event

Get details for a specific event.

curl -X GET "https://api.meetandrock.com/v1/dev/events/:eventId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update Event

Update an existing event's core details such as title, description, time range, and members.

PUThttps://api.meetandrock.com/v1/dev/events/:eventId
Update event

Update an existing event.

curl -X PUT "https://api.meetandrock.com/v1/dev/events/:eventId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Event Title",
    "description": "Updated description",
    "start_date": "2024-01-15T11:00:00Z",
    "end_date": "2024-01-15T12:00:00Z",
    "members": ["uuid", "uuid"]
  }'

Delete Event

Permanently delete an event by ID.

DELETEhttps://api.meetandrock.com/v1/dev/events/:eventId
Delete event

Delete an event.

curl -X DELETE "https://api.meetandrock.com/v1/dev/events/:eventId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Event Scheduling

Filter events by date range, type, calendar, or related task using query parameters.

Filter Events

List events with optional query parameters such as date range, event type, calendar, or associated task.

  • start_date: ISO date to filter events starting from this date.
  • end_date: ISO date to filter events ending before this date.
  • event_type: Filter by event type (e.g. meeting).
  • calendar_id: Filter by calendar.
  • task_id: Filter by associated task.
GEThttps://api.meetandrock.com/v1/dev/events?start_date=2024-01-01&end_date=2024-01-31&event_type=meeting
Filter events

List events using query parameters to narrow down results.

curl -X GET "https://api.meetandrock.com/v1/dev/events?start_date=2024-01-01&end_date=2024-01-31&event_type=meeting" \
  -H "Authorization: Bearer YOUR_API_KEY"

Event Participants

Manage event members by including a members array when creating or updating events.

Note: When updating an event, the provided members array replaces the existing list of participants.

Update participants

Pass a new members array to update who is invited to the event.

PUThttps://api.meetandrock.com/v1/dev/events/:eventId
Set event members

Replace the current event participants with a new members list.

curl -X PUT "https://api.meetandrock.com/v1/dev/events/:eventId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "members": ["user-uuid-1", "user-uuid-2"]
  }'

Event Repetition

Use the repetition field to configure recurring events.

Repetition values: only today, every day, every working day, every weekend, every monday, every tuesday, every wednesday, every thursday, every friday, every saturday, every sunday.

Create recurring event

Create an event that automatically repeats on your chosen schedule, such as every working day.

POSThttps://api.meetandrock.com/v1/dev/events
Create recurring event

Create an event that repeats according to the repetition rule.

curl -X POST "https://api.meetandrock.com/v1/dev/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Daily Standup",
    "description": "Daily team standup meeting",
    "start_date": "2024-01-15T09:00:00Z",
    "end_date": "2024-01-15T09:30:00Z",
    "repetition": "every working day",
    "event_type": "meeting"
  }'

Error responses

Typical error payloads you may encounter when working with the Event Management API.

400 Bad Request
{
  "message": "Invalid request parameters"
}

401 Unauthorized
{
  "message": "Invalid or missing API key"
}

404 Not Found
{
  "message": "Event not found"
}

500 Internal Server Error
{
  "message": "Event create failed"
}

Contents