USERS

This page documents the API endpoints for managing users within a specific event.

Enums
Some fields only allow selected values

Field	Allowed values	Default
role	organizer, attendee, guest	attendee
status	invited, accepted, declined, maybe, cancelled	invited

Scope
All routes are scoped under:

/api/v1/join/events/:events_id/users

---

LIST USERS

Returns users associated with an event.

Request

GET /api/v1/join/events/:events_id/users?limit=25&offset=0&q=alice

Response

{
  "status": "ok",
  "users": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Alice",
      "email": "alice@example.com",
      "role": "owner",
      "inserted_at": "2025-08-18T09:20:00Z",
      "updated_at": "2025-08-19T10:15:00Z"
    }
  ]
}

---

CREATE USER

Associates a user with an event.

Request

POST /api/v1/join/events/:events_id/users

Payload

{
  "user_id": "00000000-0000-0000-000000000000",
  "role": "admin"
}

Response

{
  "status": "ok",
  "user": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Alice",
    "email": "alice@example.com",
    "role": "admin",
    "inserted_at": "2025-08-18T09:20:00Z",
    "updated_at": "2025-08-19T10:15:00Z"
  }
}

---

GET USER

Fetch a specific user associated with an event.

Request

GET /api/v1/join/events/:events_id/users/:id

Response

{
  "status": "ok",
  "user": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Alice",
    "email": "alice@example.com",
    "role": "owner",
    "inserted_at": "2025-08-18T09:20:00Z",
    "updated_at": "2025-08-19T10:15:00Z"
  }
}

---

UPDATE USER

Updates the role of a user within the event.

Request

PUT /api/v1/join/events/:events_id/users/:id

Payload

{
  "role": "guest"
}

Response

{
  "status": "ok",
  "user": {
    "id": "00000000-0000-0000-0000-000000000000",
    "role": "guest",
    "name": "Alice",
    "email": "alice@example.com",
    "inserted_at": "2025-08-18T09:20:00Z",
    "updated_at": "2025-08-19T10:15:00Z"
  }
}

---

DELETE USER

Removes the association between the user and the event.

Request

DELETE /api/v1/join/events/:events_id/users/:id

Response

{ "status": "ok" }

---

Errors

404 Not Found

{
  "status": "error",
  "message": "not found",
  "error_code": "NOT_FOUND"
}

422 Validation Error

{
  "status": "error",
  "message": "invalid input",
  "error_code": "VALIDATION_ERROR",
  "fields": {
    "role": ["is invalid"]
  }
}