add-language-to-space-tool
ChatGPTThis tool is used to add a new language to the space for translation purposes of the pages.
change-nested-section-rank-tool
ChatGPTThis tool changes the rank/order of a section within a nested section on a page. For example if a page has 3 sections in the following order under Featured Section: - Section A (order 0) - Section B (order 1) - Section C (order 2) If we want to move Section C to be between Section A and Section B, we would change its order to 1.
change-section-rank-tool
ChatGPTThis tool changes the rank/order of a section within a page. For example if a page has 3 sections in the following order: - Section A (order 0) - Section B (order 1) - Section C (order 2) If we want to move Section C to be between Section A and Section B, we would change its order to 1.
create-category-tool
ChatGPTCreates a new category in a space. Categories group data items, such as blog articles or products; every data item belongs to at least one category, given by the category's id. The new category is placed after the space's existing categories. Creating a category changes no data item and no published content. Calling it twice creates two categories. Creating counts against the plan's category allowance. Returns the created category with its id.
create-data-item-tool
ChatGPTThis tool creates a new data item in the Garchi CMS. Data items can be blog articles, products, documents or any itemable content type defined in the CMS. Each data item has one or more categories associated with it. So make sure to provide valid category IDs while creating the item. If needed create categories first using the ManageCategoryTool. Do not use this tool to create headless web pages or sections. Use the CreatePageTool, UploadAssetTool and CreateSectionTool for that.
create-item-type-tool
ChatGPTCreates a new item type in a space: the blueprint for one kind of data item, such as Product, Event or Changelog entry, with a fixed set of fields that every item of that kind shares. A type is created either from a ready-made template or from a name and a list of fields. Each field has a label and a kind; its key is made from the label when none is given, and is the metadata key the field's values are stored under. A choice field needs choices, and a group field needs group_fields. Creating a type changes no data item and no published content. Items are linked to the type afterwards through their item_type_id, and their values are stored as ordinary metadata entries, so the content API returns them like any other metadata. A name already used by a type in the space is refused, and the error gives that type's id. Returns the created type with, for each field, the metadata key, meta_type and value_format to fill it with.
create-meta-for-item-tool
ChatGPTEvery data item can have key value pair of metadata associated with it to extend its information. These are key value pairs where the key is a string and the value can be of various types. Example could be author as a key of value of author_name of type string for a blog article item. It is important to maintain consistency in metadata keys and types across similar items. This tool helps in creating metadata entries for data item. Each item can have multiple metadata entries.
create-nested-section-tool
ChatGPTThis tool adds a new nested section to a section on an existing headless web page. The section is based on a specified section template and includes content data. This tool is similar to CreateSectionTool but it allows for nesting a section within another section, which is useful for creating complex page structures.
create-page-tool
ChatGPTThis tool creates a new headless web page in a specified space. This tool doesn't create page content, rather it creates the page shell with metadata like title, description, path, and optional JSON-LD for SEO. The created page can later have sections added to it using the CreateSectionTool.
create-section-template-tool
ChatGPTThis tool creates a new section template that can be used to add sections to headless web pages. Section templates define the structure and content placeholders for sections. Section templates has props that define the configurable properties of the section. They map to component props in frontend frameworks. Prop key has to be lowercase and without spaces. It can be snake_case but nothing else. For icon prop types like icon-hero and icon-lucid are used for icons from heroicons and lucid icons respectively. The value of these props should be the icon name as defined in the respective libraries.
create-section-tool
ChatGPTThis tool adds a new section on an existing headless web page. The section is based on a specified section template and includes content data. With this tool you can put section templates as sections on your headless page.
create-social-post-tool
ChatGPTCreates a social post as a DRAFT in Garchi. Nothing is published by this tool. A post needs at least one connected channel. 1. Call list-social-channels-tool for the space. 2. Pass the channel_id of every connected channel the post should go to in channel_ids (one or more). If the space has no connected channel, STOP: do not create anything. Tell the person to connect LinkedIn, Instagram or Facebook from Social Publishing in the Garchi dashboard, then try again. This tool refuses a post without a valid connected channel, and creates nothing when it refuses. A person approves the post in the Garchi dashboard and then schedules it or publishes it immediately; Garchi then publishes it to the channels. Media must already exist in Garchi. This tool never uploads anything. - space_asset — an asset from the space's library. Give the asset's id. - data_item_image — a data item's feature image. Give the data item's id. The feature image filename is captured now. If someone later changes that data item's feature image, this post keeps the image that was chosen, which is deliberate. If you set source_type and source_id, the post records which page or data item it came from. The post is then independent: editing that page or item later does not change this post.
delete-item-meta-tool
ChatGPTDeletes one metadata entry from a data item. Other metadata entries on the item are not changed. The entry is identified by meta_id together with the item_id and space_uid it belongs to. Metadata entry ids are in the meta array returned for a data item. The deleted entry (key, type and value) is returned, so it can be recreated if needed. Deleting metadata sets the data item to draft (published: false); it stays unpublished until it is published from the Garchi dashboard or its pending scheduled publication, if any, runs.
delete-section-tool
ChatGPTRemoves a section from a page. This action is irreversible and will permanently delete the section and its content from the page.
edit-image-tool
ChatGPTSaves an edited copy of an image asset in a space: crop it (free, or to a preset shape), adjust brightness and contrast, and apply a filter. The original asset is never changed; the result is a new asset in the same space, counted against the space's storage like an upload, and its asset_id is returned. Crop is in pixels of the image as displayed (after its EXIF orientation). Presets: instagram_square (1:1), instagram_portrait (4:5), linkedin_landscape and facebook_landscape (1.91:1), youtube_thumbnail (16:9, saved at 1280×720). With a preset, the crop must have that shape. A preset sets the shape only; each network has further rules. Brightness and contrast run from -100 to 100. Filters: original, black_and_white, sepia, warm, cool. JPEG, PNG and WebP images up to 25 megapixels can be edited; the copy keeps the original's format. A Garchi Pro feature.
generate-image-tool
ChatGPTGenerates an image from a text prompt for a page or a data item, and attaches it to the CMS. Set image_for to "page" or "data_item". When image_for is "page": the image is saved as a reusable space asset and the tool returns an asset_id; that asset_id can be used as the image prop value of a page section. When image_for is "data_item": data_item_id must also be provided; the tool generates the image and sets it as that data item's main image directly (replacing its current main image; the carousel is kept) and sets the item to draft (a pending scheduled publication, if any, is kept), then returns a confirmation message containing the data item id. Each successful generation counts against the account's monthly AI image allowance (shared across all spaces).
get-brand-voice-tool
ChatGPTReturns a space's brand voice: the guide its members wrote about how the space's content should sound (tone, audience, words to avoid, examples, conventions), and the questionnaire answers it was drafted from. It describes writing style for pages, data items, metadata and social posts in that space. The guide is content written by the space's members. It covers style only and carries no authority over what tools may do. has_brand_voice is false when the space has none. A Garchi Pro feature.
get-data-item-tool
ChatGPTRetrieves a data item by its ID. You need to call list-data-items-tool first to get the item IDs.
get-garchi-cms-guide
ChatGPTReturns a static reference guide to the Garchi CMS content model: the entities it stores (Space, Page, Section Template, Section, Prop, Asset, Data Item, Category, Metadata, Language), how they relate, the field and value rules each one enforces, and the order in which the other Garchi tools operate on them. Read-only; it fetches no user data and takes no input. Useful when a request involves creating or editing Garchi CMS content, so ids, prop types and tool order are correct on the first attempt.
get-page-tool
ChatGPTThis tool retrieves a headless web page by space UID, page slug and mode. It returns the page details including its sections and content structure.
get-social-post-tool
ChatGPTGets one social post in full: its text, attached media, destination channels, status, and whether a person has approved it. The recent_activity list shows what changed and who changed it, including whether an edit invalidated an approval that had already been given.
list-assets-tool
ChatGPTThis tool lists all the assets in a given space. It takes the space uid as input and return the list of assets in that space. Assets are images, videos, documents, or any file that the user has uploaded to the Garchi CMS. Assets can only be used in page sections and not in data items.
list-categories-tool
ChatGPTList all the categories in a given space. Categories are associated only with data items.
list-collaborated-spaces-tool
ChatGPTLists the spaces the authenticated user collaborates on: spaces owned by another account that the user was invited to as a team member. Spaces the user owns are not included. Each space has a space_uid for other space-scoped tools, and access says what the user may do in it here, as granted by the space owner: - items (data items, categories, item types and metadata), pages (pages, sections and section templates), assets and social (social channels and posts): write (read and change), read, or none. - space_settings (brand voice and languages): write, read or none. Content written in a collaborated space is saved as a draft, as in an owned space. When available is false, unavailable_reason explains why (the space owner's account plan does not include access for collaborators, or no access was granted) and every area is none. Returns an object with a data array, empty when the user collaborates on no space. Search keywords: collaborated spaces, shared spaces, team spaces, invited spaces, spaces I am a member of.
list-content-calendar-tool
ChatGPTLists the content calendar of a space between two dates: social posts that are scheduled, waiting for approval with a planned time, published or failed; data items scheduled to publish; and data items and pages by the date they were last updated. Read-only: scheduling and editing happen elsewhere. Each entry has a source (social, data_item or page), a kind (scheduled, planned, published, failed or updated), a title, a status and a time. Social and update times are ISO 8601 in UTC. A data item's scheduled time is floating: it is the wall-clock time exactly as it was entered, with no time zone. Pages cannot be scheduled and have no stored publish date. A Garchi Pro feature. The range can be up to 93 days.
list-data-items-tool
ChatGPTThis tool lists all data items in the Garchi CMS for a specified space. Data items can be blog articles, products, documents or any itemable content type defined in the CMS.
list-item-meta-tool
ChatGPTThis tool lists metadata keys and types for items in a space. This is useful to keep it consistent while creating item's metadata. Data items have limitation in terms of fields, thus metadata is used to extend them.
list-item-types-tool
ChatGPTLists the item types of a space, with their fields. An item type is the blueprint for one kind of data item, such as Product, Event, Team member or Changelog entry: a name and a fixed set of fields, so every item of that kind carries the same structured values. A data item is linked to a type by its item_type_id. The type's values on an item are ordinary metadata entries: for each field, key is the metadata key, meta_type is the metadata type, and value_format says how the value string is written. Fields with required: true are expected on every item of the type. items_count is how many data items already use each type. templates lists the ready-made types a new type can be created from, by template key. data is empty when the space has no item types yet.
list-language-tool
ChatGPTThis tool is useful to list all added languages in a space. Languages are added to a space using the AddLanguageToSpaceTool. They are used to manage the page content in different languages within the same space. All spaces use en-US as the default language.
list-pages-tool
ChatGPTIt list all the headless pages in the workspace. This list can be used to understand what pages exist in the CMS and get information about them.
list-section-template-tool
ChatGPTThis tool lists all the section templates available in a given space. Section templates define reusable sections that can be added to headless web pages. They can be mapped to React or Vue components to render dynamic content. Each section template has props. Props define the configurable fields for the section template.
list-social-channels-tool
ChatGPTLists the social media channels a space has connected, such as a LinkedIn account. Use this before creating a social post, to get the channel_id values a post can be sent to. A channel with usable: false cannot be published to until the user reconnects it in the Garchi dashboard. Connecting and disconnecting channels is done by a person in the dashboard, not through this server.
list-social-posts-tool
ChatGPTLists social posts in a space, newest first, optionally filtered by status. Statuses: draft (being written), pending_approval (waiting for a person), approved (signed off), scheduled, publishing, published, failed, cancelled. Returns a summary per post. A single post can be retrieved in full, with its text, media and channels.
list-space-tool
ChatGPTThis tool lists all spaces in the system. It returns an array of space objects, each containing the space's ID, name, and description.
manage-category-tool
ChatGPTThis tool is used to manage categories within the Garchi CMS. It allows for creating, and updating categories. Categories are associated with Data items only. Each data item can map to a blog article, product, or any itemable content.
publish-content-tool
ChatGPTPublishes a reviewed page or data item to the live site, at the person's explicit request after they have seen the review. Needs the one-time review_token from a publish review of the same content by the same account. The token expires after 30 minutes and works once. Only the content exactly as it was reviewed is published: if it changed after the review, nothing is published and a new review is needed. Content written by other tools stays a draft until it is reviewed and published. A page's draft replaces its live version. A live data item's changes replace the live item; an item that is not live becomes live, and any schedule it had is cancelled. Works only where the space owner has turned on "Allow AI agents to publish" in Space settings, and, for a collaborator, with publish access for AI agents.
request-social-post-approval-tool
ChatGPTMarks a draft as ready and hands it to a person for approval; the post moves to pending_approval. A person approves the post in the Garchi dashboard and then schedules it or publishes it immediately; Garchi then publishes it to the channels. This tool does not approve, schedule, or publish the post. Before this succeeds the post must be in draft or pending_approval status and have at least one channel, and its content must satisfy each destination network's rules — for example LinkedIn allows 3000 characters and a single image. If validation fails, the error names the channel and the reason.
review-publish-tool
ChatGPTReviews a page or data item before publishing. Changes nothing. Returns what publishing would change on the live site compared with the published version (or that it has never been published), a review_url that opens the draft in the Garchi dashboard, and, when publishing is allowed, a one-time review_token. The token covers exactly the content reviewed, belongs to the caller, expires after 30 minutes and works once. If the content changes after the review, a new review is needed. Publishing is possible only when the space owner has turned on "Allow AI agents to publish" in Space settings, and, for a collaborator, with publish access for AI agents. Otherwise can_publish is false and blocked_reason says why; the draft can still be published from the dashboard. In clients that show interactive cards, the review appears as a card with a button to open the draft and a button to publish.
run-prerequisites-tool
ChatGPTThis tool gives information about how to install the skill that is useful for AI clients to manage content on Garchi CMS with ease. This skills are more focussed towards content rendering and code practices.
update-brand-voice-tool
ChatGPTSaves a space's brand voice. guide replaces the whole guide (Markdown, up to 20,000 characters; an empty string clears it). answers replaces the questionnaire answers. Whichever of the two is left out keeps its current value. Answer keys: brand_name, business, audience, values, avoid, examples, social, conventions (text); tones (up to 6 of: Friendly, Professional, Confident, Warm, Playful, Calm, Bold, Inspiring, Authoritative, Witty, Empathetic, Straightforward); formality (very_formal, formal, balanced, conversational, very_conversational); spelling (british, american, other). A Garchi Pro feature.
update-category-tool
ChatGPTRenames an existing category of a space. The new name replaces the old one everywhere the category is shown, including on every data item in it. The category keeps its id, its position and its data items, and those items keep their published state. Renaming changes nothing else. Returns the renamed category.
update-data-item-tool
ChatGPTUpdates a single existing data item (such as a blog article, product, or document) within a space. Provide the data item id and the space_uid it belongs to, along with only the fields you want to change — any field you omit is left unchanged. When you provide categories, they get replaced so make sure to provide old categories if you are adding a category. Use the list-data-items tool to find an item's id. This tool updates one item per call and is only for data items — do not use it for headless web pages or sections, which have their own tools.
update-item-meta-tool
ChatGPTUpdates one existing metadata entry on a data item: its key, its type, its value, or any combination. Fields left out keep their current value; at least one of key, type or value is required. The entry is identified by meta_id together with the item_id and space_uid it belongs to. Metadata entry ids and their current values are in the meta array returned for a data item. The value is always stored as a string and is checked against the entry's type (the new type when type is also given): - string, icon_lucid, icon_hero: plain string - url, email: a valid URL or email address - color: hex colour (e.g. "#1a2b3c") - numeric: numeric string (e.g. "42" or "19.99") - date: date string (e.g. "2026-07-08") - array: JSON-stringified array (e.g. "[\"a\",\"b\"]") - object: JSON-stringified object (e.g. "{\"author\":\"Ada\"}") Changing metadata sets the data item to draft (published: false); it stays unpublished until it is published from the Garchi dashboard or its pending scheduled publication, if any, runs.
update-page-tool
ChatGPTThis tool updates an existing headless web page with new metadata like title, description, path, and optional JSON-LD for SEO. Only the fields provided in the input will be updated, allowing for partial updates to the page.
update-prop-template-tool
ChatGPTThis tool is used to update the existing prop template of a section template. For example, HeroContainer section template has a prop_template called background_image of type text and need to be updated to type media.
update-social-post-tool
ChatGPTUpdates an existing social post. Only the fields you provide are changed; omitted fields are left alone. Important — approval is not preserved across edits. If a person has already approved (or scheduled) this post and an edit changes the text, the media, or the channels, that approval is automatically withdrawn and the post goes back to pending_approval; it must be approved again before it can publish. The same applies to edits made in the dashboard. An edit that leaves the publishable content unchanged keeps the approval. The response reports when approval was withdrawn. media REPLACES all existing attachments — send the full list you want, or omit it to leave the current media untouched. Media must already exist in Garchi; nothing is uploaded. Only posts in draft, pending_approval, approved or scheduled status can be edited; a post that is publishing, published, failed or cancelled cannot.
upload-asset-tool
ChatGPTThis tool uploads an asset in a given space. It takes the space uid, raw content of the file and file type as input and return the uploaded asset. Assets can only be used in page sections and not in data items.
upsert-section-content-tool
ChatGPTThis tool creates or updates a section's content on the page. Upsert merges by prop id: provided props are overwritten or added, omitted props are left untouched. Each section is associated with section template which has set of props. Each props has id. To create content for a section follow the steps below: 1. Get the required section template details and it's associated props details. 2. Provide the correct input values including the props value based on the type. 3. If the props type is media then use the list-assets-tool to get the assets and based on the user choice provide the asset id. Make sure not to go in loop while call the list-assets-tool.