> ## Documentation Index
> Fetch the complete documentation index at: https://developer.swoogo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Audits & schemas

> Field definitions, registration audits, call-for-speakers, and invitation lists

## Common Parameters

These parameters appear in multiple tools:

| Parameter  | Type    | Description                               |
| ---------- | ------- | ----------------------------------------- |
| `page`     | integer | Page number (default: 1)                  |
| `per_page` | integer | Results per page (default: 20, max: 1000) |
| `sort`     | string  | Sort field (prefix `-` for descending)    |
| `name`     | string  | Filter by name (partial match)            |

***

## swoogo\_fields\_get

List the field definitions Swoogo stores for an object type: attribute name, label, input type, and the choice IDs for dropdown, radio and checkbox fields. Schemas are account-level; omit `event_id`.

Call this before any create or update tool that takes custom fields or ID-valued fields. For example: `{ object: "sponsor" }` returns level IDs that `swoogo_create_sponsor` accepts. `{ object: "contact" }` returns contact fields that `swoogo_contacts_save` accepts.

### Parameters

| Parameter   | Type    | Required | Description                                                                  |
| ----------- | ------- | -------- | ---------------------------------------------------------------------------- |
| `object`    | string  | Yes      | Which object's fields to return: `contact`, `event`, `session`, or `sponsor` |
| `field_id`  | integer | No       | Get one field by ID, with its full choice list                               |
| `attribute` | string  | No       | Search by Swoogo attribute name (partial match), e.g. `c_62` or `level`      |
| `name`      | string  | No       | Search fields by label (partial match)                                       |

See [Common Parameters](#common-parameters) for `page`, `per_page`, `sort`.

### Example prompts

* *"What are the level IDs for sponsors?"*
* *"List the custom fields on contacts"*

***

## swoogo\_audits\_get

Audit session bookings or registration status changes for an event's registrants in a time window.

### Parameters

| Parameter     | Type    | Required | Description                                                                               |
| ------------- | ------- | -------- | ----------------------------------------------------------------------------------------- |
| `event_id`    | integer | Yes      | The event to audit                                                                        |
| `start_time`  | string  | Yes      | Return only changes made after this time, `YYYY-MM-DD HH:MM:SS` UTC                       |
| `end_time`    | string  | No       | Return only changes made before this time. Defaults to now                                |
| `scope`       | string  | No       | `sessions` (default) audits session bookings, `registrations` audits registration status  |
| `status_mode` | string  | No       | Omit for the change itself, `current` for the value as it stands now, `combined` for both |

### Example prompts

* *"What session changes happened for event 12345 since 2026-09-01?"*
* *"Show registration status changes for this event in the last week"*

***

## swoogo\_cfs\_get

Query call-for-speakers records for an event: submissions, reviews, or the submitters and reviewers with their CFS roles.

### Parameters

| Parameter   | Type    | Required                   | Description                                                      |
| ----------- | ------- | -------------------------- | ---------------------------------------------------------------- |
| `resource`  | string  | Yes                        | Which records to return: `submissions`, `reviews`, or `contacts` |
| `event_id`  | integer | No (required when listing) | The event whose call-for-speakers data to read                   |
| `record_id` | integer | No                         | Get one record of the chosen resource by ID                      |

See [Common Parameters](#common-parameters) for `name`, `page`, `per_page`, `sort`.

### Example prompts

* *"List all speaker submissions for event 12345"*
* *"Show the reviews for the submission titled 'AI in Healthcare'"*
* *"Show review 789"*

***

## swoogo\_invitation-lists\_get

List or retrieve invitation lists for an event, or the contacts on a specific list.

### Parameters

| Parameter            | Type    | Required                   | Description                                                                            |
| -------------------- | ------- | -------------------------- | -------------------------------------------------------------------------------------- |
| `event_id`           | integer | No (required when listing) | The event whose invitation lists to return                                             |
| `invitation_list_id` | integer | No                         | Get a specific invitation list by ID                                                   |
| `include_contacts`   | boolean | No                         | With `invitation_list_id`, return the contacts on that list instead of the list itself |

See [Common Parameters](#common-parameters) for `name`, `page`, `per_page`, `sort`.

### Example prompts

* *"List the invitation lists for event 12345"*
* *"Who's on invitation list 456?"*