Event Management API

Base URL

All URLs referenced in the documentation have the following base:

https://api.meetandrock.com/v1/dev

Event Management

Endpoints for managing 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"

Response:
{
  "data": [
    {
      "id": "uuid",
      "title": "string",
      "description": "string",
      "start_date": "datetime",
      "end_date": "datetime",
      "event_type": "string",
      "repetition": "string",
      "calendar_id": "uuid",
      "task_id": "uuid",
      "project_id": "uuid",
      "created_by": "uuid",
      "members": ["uuid", "uuid"],
      "createdAt": "datetime",
      "updatedAt": "datetime"
    }
  ]
}

Create Event

Create a new event

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"]
  }'

Response:
{
  "data": {
    "id": "uuid",
    "title": "Team Meeting",
    "description": "Weekly team sync",
    "start_date": "2024-01-15T10:00:00Z",
    "end_date": "2024-01-15T11:00:00Z",
    "members": ["uuid", "uuid"],
    ...
  }
}

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

Get Event

Retrieve details of a specific event

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

Response:
{
  "data": {
    "id": "uuid",
    "title": "string",
    "description": "string",
    "start_date": "datetime",
    "end_date": "datetime",
    "event_type": "string",
    "repetition": "string",
    "members": ["uuid"],
    ...
  }
}

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"]
  }'

Response:
{
  "data": {
    "id": "uuid",
    "title": "Updated Event Title",
    "members": ["uuid", "uuid"],
    ...
  }
}

Delete Event

Delete an event

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

Response: 201 No Content

Event Scheduling

Query parameters for filtering events

Filter Events

List events with optional query parameters

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"

Query Parameters:
- start_date: Filter events starting from this date
- end_date: Filter events ending before this date
- event_type: Filter by event type
- calendar_id: Filter by calendar
- task_id: Filter by associated task

Event Participants

Managing event members/participants

Add Participants

Add members to an event when creating or updating

# When creating an event
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",
    "start_date": "2024-01-15T10:00:00Z",
    "end_date": "2024-01-15T11:00:00Z",
    "members": ["user-uuid-1", "user-uuid-2", "user-uuid-3"]
  }'

# When updating an event
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"]
  }'

Note: The members array contains user IDs. When updating, the entire members list is replaced.

Event Repetition

Setting up recurring events

Recurring Events

Create events that repeat on a schedule

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"
  }'

Repetition values:

only today - Single occurrence
every day - Daily
every working day - Monday to Friday
every weekend - Saturday and Sunday
every monday, every tuesday, etc. - Weekly on specific day

Error Responses

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"
}

Event Management API

Base URL