Eventtia

Deletes a deposit payment. Only payments with `operation = deposit` are deletable.

delete_payment

Enrolls an attendee in a specific workshop session. This endpoint safely handles concurrent requests to prevent overbooking and automatically recomputes related attendee charges. ### Validation Rules * **Availability:** Checks seat capacity and enforces per-attendee-type limits. * **Scheduling:** Prevents double-enrollment and time overlaps with other registered sessions. * **Timeline:** Ensures the booking deadline has not passed.

enroll_attendee_in_session

Returns a single non-archived checkpoint by ID for the event. Requires `view_checkpoints` permission.

get_checkpoint

Returns the ordered list of form fields the admin uses to create an Attendee of this AttendeeType. Includes default fields (first_name, email, etc.) and custom fields. Includes admin-only fields. Skips fields with display=false.

get_attendee_type_form_schema

Returns a single attendee scoped to the event by its `attendee_uuid`. Cached for 5 minutes.

get_attendee

Returns the event-level check-in status of an attendee. Indicates whether the attendee has checked in to the event and, if so, the check-in timestamp converted to the event's local timezone (format: YYYY-MM-DD HH:MM:SS).

get_attendee_event_checkin

Returns a single attendee type by ID.

get_attendee_type

Returns the details of a single event by its UUID. Authentication is optional. When unauthenticated, only non-archived public events are returned.

get_event

Returns boolean flags indicating which modules (activities, checkpoints) are enabled for the event.

get_event_modules

Returns lightweight aggregated metrics for an event: attendee totals (`attendees`: non-draft, non-archived registrations in any confirmation state; `drafts`; `rejected`: archived without confirmation), date range with timezone, per-attendee-type seat usage, and top 5 workshops by check-in count. All counts are computed with grouped SQL queries (no N+1) regardless of the number of attendee types or workshops. **Caching:** Responses are cached for 1 minute.

get_event_summary

Returns a single speaker by ID, scoped to the event.

get_speaker

Returns a single workshop definition by GUID.

get_workshop

Returns a single workshop session by GUID.

get_session

Returns used seats and check-in counts for a single workshop session. `guid` is the session GUID returned by `list_sessions`/`get_session`, not the workshop definition GUID used by `get_workshop`.

get_workshop_stats

Returns a paginated list of checkpoint check-in logs for an attendee. Each log records an entry (and optional exit) at a named checkpoint. Includes the checkpoint name, entry timestamp, and checkout status. Logs are ordered by creation time descending (most recent first). The response includes `total_entries` for the unfiltered count.

list_attendee_checkpoint_checkins

Returns the payments (deposits and charges) for a given attendee.

list_payments

Returns the form fields configured for an attendee type. Default fields (`first_name`, `email`, etc.) and custom fields are both included. **Filters:** by default returns only active fields (`archived: false`, `draft: false`). Override with `?archived=true|all` and `?draft=true|all`.

list_attendee_type_custom_fields

Returns per-group capacity limits for an attendee type.

list_attendee_type_group_limits

Returns a paginated list of attendee types for an event. Only non-archived, non-draft types are returned.

list_attendee_types

Returns a paginated list of workshop check-ins for an attendee. Only includes workshops where the attendee has an active registration AND has physically checked in (checked_in = true). Results are ordered by check-in date descending (most recent first). The response includes `total_entries` for the unfiltered count.

list_attendee_workshop_checkins

Returns a paginated list of attendees for a given event. By default only non-archived, non-draft, non-rejected attendees are returned. Use the filter query parameters to change this scope.

list_attendees

Returns the paginated list of non-archived checkpoints for the event. Requires `view_checkpoints` permission.

list_checkpoints

Returns the account-level custom field definitions applicable to every event in the authenticated user's account. This endpoint is **account-scoped**, not event-scoped: it takes no `uuid` path parameter. The `id` of each definition (cast to string) is the key expected inside `custom_fields_data` on `create_event` / `update_event`. Only active fields are returned (`archived: false`, `draft: false`), ordered by `order` ASC. **Caching:** Responses are cached for 30 minutes.

list_event_custom_fields

Returns a paginated list of events belonging to the authenticated user's account. Events are filtered by the user's security access level and account scope. Archived events are excluded automatically. **Sorting:** Use the `order` parameter to sort results. Format: `column_name direction` (e.g., `start_date desc`, `name asc`). Supports up to two sort fields separated by comma. **Pagination:** Default page size is 24 (max 24). Use `page[number]` and `page[size]` to control pagination. **Caching:** Responses are cached for 1 minute. **Rate limit:** 100 requests/minute per IP (600 for whitelisted IPs).

list_events

Returns a paginated list of speakers for an event. By default only non-archived, non-draft speakers are returned. Use `?archived=true` to list only archived speakers, or `?archived=all` to include both.

list_speakers

Returns a paginated list of workshop definitions for an event. Excludes archived, sponsor-owned and empty (no active sessions) definitions by default.

list_workshops

Returns the sessions (concrete time-slots) registered under a WorkshopDefinition.

list_sessions

Registers a new attendee for the event. The payload is wrapped under the `attendee` key. **Required fields:** `first_name`, `last_name`, `email`, `attendee_type_id`. (`email` may be skipped only when the selected `attendee_type` has `email_required` disabled; default is required.) If a draft attendee already exists for the same email + event it is promoted; otherwise a new attendee is created and registered. An optional top-level `coupon_code` is applied after a successful registration. **Precondition:** registration must be enabled for the event; otherwise the request fails with `422 "Registration for this event is not enabled"`. Side effect: may send the event's welcome email to the attendee's own inbox, if the attendee type has welcome emails enabled and the registration is not left as a draft.

create_attendee

Creates a manual deposit payment for an attendee. Internally calls `Payment.manual_payment(attendee, params, current_user)` with operation_type set to `deposit`.

create_payment

Rejects an attendee registration. Archives the attendee if previously confirmed and unchecks-in if checked in. Side effect: sends a rejection email to the attendee's own inbox. Sent mail cannot be recalled.

reject_attendee

Resends the welcome/confirmation email to a confirmed attendee. Returns 422 if the attendee is not eligible (draft, archived, unconfirmed, missing email, no attendee_type, or unpaid when payment is required).

resend_attendee_email

Case-insensitive substring search over the global `cities` catalog. Useful to resolve a human-readable location into a numeric `city_id` before creating an offline or mixed event. Each result is preloaded with its `region` and `country` to avoid N+1 queries on the caller side. **Behavior:** - Matches `name LIKE "%q%"` (substring, case-insensitive in MySQL `utf8_general_ci`). - Wildcards `%` and `_` in `q` are escaped — no client-side wildcard matching. - Optional `country_iso_code` narrows results to a single country (case-insensitive). - Results are ordered by `name ASC`. - Capped at **20 results** (no pagination — refine the query instead). - Response is cacheable for 30 minutes (`Cache-Control: public, max-age=1800`). **Rate limit:** 100 requests/minute per IP (600 for whitelisted IPs).

search_cities

Removes an attendee's enrollment from a specific workshop session. ### Key Effects * **Participation:** Cancels the attendee's registration for this session. * **Charges:** Triggers an automatic recomputation of the associated attendee charges. **⚠️ DESTRUCTIVE OPERATION** LLM/MCP clients MUST obtain explicit end-user confirmation before invoking: present the target resource with user-recognizable identifiers and receive an affirmative response. Confirmation MUST NOT be inferred from dialogue or context.

unenroll_attendee_from_session

Updates an existing checkpoint. Requires `edit_checkpoints` permission. Only fields included in the request body are updated.

update_checkpoint

Updates the profile of an existing attendee. Payload is wrapped under the `attendee` key. Only provided fields are modified. Side effect: may send the event's welcome email to the attendee's own inbox, if the attendee type has welcome emails enabled and the email had not been sent yet.

update_attendee

Updates an existing attendee type. Only provided fields are modified.

update_attendee_type

Updates an existing custom field. Default fields support a restricted set of mutations (only `required`, `display`, `allow_duplicate_values` for `email`, `min_age` for `birthdate`).

update_attendee_type_custom_field

Updates an existing event. Only the provided fields are modified.

update_event

Updates an existing speaker. Only provided fields are modified. Image fields (`picture`, `banner`) are not supported via this API. The `attendee` association is not exposed in this version.

update_speaker

Updates a workshop definition. Only `name` and `description` (multilingual) are accepted; nested `workshops_attributes` is ignored on update.

update_workshop