# Agility CMS

Agility CMS is a headless content management system that allows developers to build and manage digital experiences across various platforms.

- **Category:** website builders
- **Auth:** API_KEY
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `AGILITY_CMS`
- **Version:** 20260211_00

## Tools

### Get Authors

**Slug:** `AGILITY_CMS_GET_AUTHORS`

Retrieves a paginated list of authors from Agility CMS. Use this tool to get all authors with support for pagination, filtering, sorting, and field selection. The 'authors' content list must exist in your Agility CMS instance. Supports expanding linked content to specified depths.

### Get Categories

**Slug:** `AGILITY_CMS_GET_CATEGORIES`

Retrieves all categories from your Agility CMS instance for a specific locale. Use this action when you need to: - List all available categories in your content structure - Get category metadata including contentID and custom fields - Retrieve categories for a specific language/region Categories are typically used to organize and classify content items in Agility CMS. The response includes complete category details with fields and properties.

### Get Content Item

**Slug:** `AGILITY_CMS_GET_CONTENT_ITEM`

Tool to fetch details of a content item by Content ID. Use when you need item fields and metadata from Agility CMS.

### Get Content List

**Slug:** `AGILITY_CMS_GET_CONTENT_LIST`

Retrieves a paginated list of content items by reference name from Agility CMS. Use this action to: - Fetch multiple content items of a specific type (e.g., blog posts, products, authors) - Retrieve content with pagination, filtering, and sorting capabilities - Expand linked content to specified depths Required parameters: instance GUID, API type (fetch/preview), locale code, and lowercase reference name. Tip: Use Get Content Models action first to discover available reference names for your instance.

### Get Content Models

**Slug:** `AGILITY_CMS_GET_CONTENT_MODELS`

Tool to retrieve content models and page modules. Use when you need schema definitions to dynamically build content structures.

### Get Logs

**Slug:** `AGILITY_CMS_GET_LOGS`

Retrieve sync items (content change logs) from Agility CMS using the Content Sync API. This tool implements incremental content synchronization: - Use syncToken='0' for initial full sync (retrieves all content) - Use the returned syncToken in subsequent calls to get only new/updated content - Maximum pageSize is 500 items per request - Continue pagination until syncToken='0' is returned (indicating you're up to date) Typical workflow: 1. Call with syncToken='0' to get initial content batch 2. Store the returned syncToken 3. On next sync, pass the stored syncToken to get only changes since last sync 4. Repeat until syncToken='0' (no more updates)

### Get Page

**Slug:** `AGILITY_CMS_GET_PAGE`

Tool to retrieve details of a Page, including metadata, content zones, and components. Use after you know the page_id to fetch.

### Get Page Modules

**Slug:** `AGILITY_CMS_GET_PAGE_MODULES`

Retrieves page module definitions from Agility CMS. Page modules are UI components that can be added to pages. This action fetches all model definitions and filters to return only page modules (definitions without contentReferenceNames). Use this to understand what page modules are available for building pages. For content type definitions, use Get Content Models instead.

### Get Sitemap Flat

**Slug:** `AGILITY_CMS_GET_SITEMAP_FLAT`

Retrieves the flat sitemap for a specific channel and locale in Agility CMS. Returns a dictionary mapping page paths to sitemap items containing page metadata, SEO info, and routing details. Use this when you need to get all pages and their URLs for implementing page routing, generating sitemaps, or navigating the site structure. Required: instance GUID, API type (fetch/preview), locale code, and channel name.

### Get Tags

**Slug:** `AGILITY_CMS_GET_TAGS`

Retrieves all tags defined in the Agility CMS instance for a specific locale. Tags are used to categorize and organize content items. Use this action when you need to list all available tags for content tagging or filtering purposes.

### Sync Content Items

**Slug:** `AGILITY_CMS_SYNC_CONTENT_ITEMS`

Retrieves content items incrementally using sync tokens for efficient synchronization. Use this tool to: - Perform initial full sync (syncToken=0) to get all content items - Get incremental updates by passing the returned syncToken from previous calls - Page through large content datasets efficiently (up to 500 items per page) The sync token mechanism ensures you only fetch changed content, making this ideal for maintaining local copies of Agility CMS content without repeated full downloads.

### Sync Pages

**Slug:** `AGILITY_CMS_SYNC_PAGES`

Retrieves all page items from Agility CMS in paged format with sync tokens for incremental updates. Use this to synchronize local page data with the CMS. Start with syncToken=0 for initial sync, then use the returned syncToken in subsequent calls to get only changed pages. Each response includes page metadata, SEO fields, visibility settings, and script configurations.
