CMS API reference

Audit SEO

cms.audit_seoread

Audit every CMS entry on a website for missing or oversized search metadata, missing social images, thin content, long slugs, and published no-index mistakes. This read-only check changes nothing.

Parameters

Field	Type	Required	Description
funnel_id	string (uuid)	required	Website whose CMS content should be audited.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.audit_seo \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "funnel_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_audit_seo at https://app.chirply.io/api/mcp, same bearer token, same input.

Create blog

cms.create_blogwriteadmin only

Create an SEO-ready Blog collection and a draft visual article template inside an existing website. Publish the template with the website before publishing articles. This publishes nothing and sends nothing externally.

Parameters

Field	Type	Required	Description
funnel_id	string (uuid)	required	Website that will own the blog and its visual article template.
name	string	optional	Editor-facing name for the blog. Default: "Blog"
path	string	optional	Public URL prefix used before every article slug. Default: "blog"

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.create_blog \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "funnel_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_create_blog at https://app.chirply.io/api/mcp, same bearer token, same input.

Create collection

cms.create_collectionwriteadmin only

Create a structured content collection for one website. Its entries remain drafts until individually published; nothing becomes public from this action.

Parameters

Field	Type	Required	Description
funnel_id	string (uuid)	required	Website that owns this collection.
name	string	required	Editor-facing collection name, such as Blog posts or Team members.
slug	string	optional	Stable internal collection slug; generated from name when omitted.
path	string	optional	Public URL prefix, such as blog; generated from name when omitted.
description	string	optional	What editors should store in this collection.
fields	object[]	required	Structured fields available to entries and {{cms.key}} page bindings.
fields[].key	string	required	Permanent machine key used in {{cms.key}} bindings.
fields[].label	string	required	Human label shown to content editors.
fields[].type	"text" \| "richtext" \| "number" \| "boolean" \| "date" \| "image" \| … 1 more	required	Editor and validation type for this field.
fields[].required	boolean	optional	Whether publishing requires a value. Default: false
fields[].help	string	optional	Short instruction shown beside the field.
template_page_id	string (uuid) (or null)	optional	Published visual page used to render every entry, or null until one is designed.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.create_collection \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "funnel_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "name": "Example",
    "fields": [
      {
        "key": "example",
        "label": "example",
        "type": "text"
      }
    ]
  }'

Test with your API key

Over MCP the same operation is the tool cms_create_collection at https://app.chirply.io/api/mcp, same bearer token, same input.

Create entry

cms.create_entrywriteadmin only

Create a CMS entry as a private draft. Structured values are validated against the collection schema and nothing becomes public until Publish entry is run.

Parameters

Field	Type	Required	Description
collection_id	string (uuid)	required	Collection that defines this entry's fields and public URL.
title	string	required	Entry title used by editors and as the default SEO title.
slug	string	optional	Public URL slug; generated from title when omitted.
excerpt	string	optional	Short summary for listings and default meta description.
data	map of string → object	required	Field values keyed by the collection's permanent field keys.
seo	map of string → object	optional	SEO overrides: title, description, canonical, ogImage, noIndex, and schemaType.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.create_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "title": "Example",
    "data": {}
  }'

Test with your API key

Over MCP the same operation is the tool cms_create_entry at https://app.chirply.io/api/mcp, same bearer token, same input.

Delete collection

cms.delete_collectionwriteconfirmadmin only

PERMANENTLY delete a collection and every draft and published entry inside it. All of its public entry URLs stop resolving immediately. This cannot be undone.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Collection and all entries to permanently delete.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.delete_collection \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_delete_collection at https://app.chirply.io/api/mcp, same bearer token, same input.

Delete entry

cms.delete_entrywriteconfirmadmin only

PERMANENTLY delete a CMS entry, including its working draft and published snapshot. Its public URL stops resolving immediately and this cannot be undone.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Entry to permanently delete.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.delete_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_delete_entry at https://app.chirply.io/api/mcp, same bearer token, same input.

Import WordPress posts

cms.import_wordpresswriteconfirmadmin only

Fetch up to 100 posts from a public WordPress REST API and add them as private drafts in an existing collection. Existing entries with the same slug are preserved; this publishes nothing. THIS MAKES AN OUTBOUND REQUEST FROM CHIRPLY'S SERVERS to whatever address is given, so everything in the URL — host, path, query string — is disclosed to whoever operates it, and whatever it answers with is stored in this account. That is why it asks for confirmation.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
collection_id	string (uuid)	required	Destination collection for imported drafts.
source_url	string (uri)	required	Public home URL of the WordPress website to import. Chirply's servers fetch this address directly.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.import_wordpress \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "source_url": "https://example.com"
  }'

Test with your API key

Over MCP the same operation is the tool cms_import_wordpress at https://app.chirply.io/api/mcp, same bearer token, same input.

List collections

cms.list_collectionsread

List the structured content collections owned by a website, including each collection's field schema, public path, and visual template page.

Parameters

Field	Type	Required	Description
limit	integer	optional	Max rows to return (1–100). Default: 25
offset	integer	optional	Rows to skip. Default: 0
funnel_id	string (uuid)	required	Website whose collections should be returned.
status	"active" \| "archived"	optional	Optionally filter by collection status.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.list_collections \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "funnel_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_list_collections at https://app.chirply.io/api/mcp, same bearer token, same input.

List entries

cms.list_entriesread

List draft, scheduled, published, or archived entries in a collection with their structured data and SEO settings.

Parameters

Field	Type	Required	Description
limit	integer	optional	Max rows to return (1–100). Default: 25
offset	integer	optional	Rows to skip. Default: 0
collection_id	string (uuid)	required	Collection whose entries should be returned.
status	"draft" \| "scheduled" \| "published" \| "archived"	optional	Optionally filter by publishing state.
search	string	optional	Case-insensitive title or slug search.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.list_entries \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_list_entries at https://app.chirply.io/api/mcp, same bearer token, same input.

Publish entry

cms.publish_entrywriteconfirmadmin only

Publish the current draft data and SEO as a public snapshot. Real visitors can immediately open the entry at the collection path on the website; the collection must have a published visual template page.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Draft entry to publish publicly.
expected_updated_at	string	optional	Exact updated_at of the saved draft reviewed for publication; rejects concurrent changes.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.publish_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_publish_entry at https://app.chirply.io/api/mcp, same bearer token, same input.

Schedule entry

cms.schedule_entrywriteconfirmadmin only

Freeze the current saved draft and SEO as a public snapshot that automatically becomes available at the specified future time. Real visitors can open it after that time; later draft edits do not change the scheduled snapshot.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Saved CMS entry to schedule.
publish_at	string (date-time)	required	Future UTC date and time when the frozen snapshot becomes public.
expected_updated_at	string	optional	Exact updated_at of the saved draft reviewed for scheduling; rejects concurrent changes.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.schedule_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "publish_at": "2026-09-17T15:00:00Z"
  }'

Test with your API key

Over MCP the same operation is the tool cms_schedule_entry at https://app.chirply.io/api/mcp, same bearer token, same input.

Unpublish entry

cms.unpublish_entrywriteconfirmadmin only

Take a published CMS entry offline immediately while preserving its working draft and last published snapshot for later republishing.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Published entry to take offline.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.unpublish_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_unpublish_entry at https://app.chirply.io/api/mcp, same bearer token, same input.

Save collection

cms.update_collectionwriteconfirmadmin only

Update a collection's name, URL prefix, field schema, status, or visual template page. Changing fields does not delete stored entry data; published entry URLs may change when path changes.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Collection to update.
name	string	optional	New editor-facing collection name.
path	string	optional	New public URL prefix.
description	string (or null)	optional	New editor guidance, or null to clear it.
fields	object[]	optional	Complete replacement field schema.
fields[].key	string	required	Permanent machine key used in {{cms.key}} bindings.
fields[].label	string	required	Human label shown to content editors.
fields[].type	"text" \| "richtext" \| "number" \| "boolean" \| "date" \| "image" \| … 1 more	required	Editor and validation type for this field.
fields[].required	boolean	optional	Whether publishing requires a value. Default: false
fields[].help	string	optional	Short instruction shown beside the field.
template_page_id	string (uuid) (or null)	optional	Visual template page, or null to detach it.
status	"active" \| "archived"	optional	Active collections resolve publicly; archived collections do not.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.update_collection \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_update_collection at https://app.chirply.io/api/mcp, same bearer token, same input.

Save entry

cms.update_entrywriteadmin only

Save an entry's working draft, slug, excerpt, or SEO settings. Published visitors continue seeing the previous published snapshot until Publish entry is run again.

Parameters

Field	Type	Required	Description
id	string (uuid)	required	Entry to update.
expected_updated_at	string	optional	Exact updated_at returned by the last read; a changed entry is rejected instead of overwriting another editor.
title	string	optional	New entry title.
slug	string	optional	New public URL slug after the next publish.
excerpt	string (or null)	optional	New listing excerpt, or null to clear it.
data	map of string → object	optional	Complete replacement draft field data.
seo	map of string → object	optional	Complete replacement draft SEO settings.

Example

curl -X POST https://app.chirply.io/api/v1/actions/cms.update_entry \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool cms_update_entry at https://app.chirply.io/api/mcp, same bearer token, same input.