Skip to main content

Resource and Space tools

The MCP tools that read any resource by kind and id, search resources, list the Spaces the user can reach, and manage content packs.

get-resource and search-resources work on any resource kind, including kinds with no dedicated get tool. A client takes the spaceId for other tools from list-spaces, which returns the Spaces the user can reach.

Tool names and schemas can change at any time

An agent sees each change the next time it reads tools/list, while a script that hard-codes a tool name or schema breaks when that tool changes.

Each section below is one tool as MCP access registers it: its title, its description, the annotations it sets, and the input and output schemas from tools/list. Field paths use parent.child for a nested object, parent[].child for the items of an array, and parent[Value].child for one variant of a field that takes several shapes.

create-folder​

Create folder.

Creates a folder in a draft changeset. Provide contentPackId to create it in a content pack; otherwise use the active space. Use folderPath for placement. Read the result with get-resource.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
namestringRequiredMust not be empty. At most 256 characters.
folderPathstringRequired
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
contentPackIdstringOptionalPattern: ^PAK_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
idstringThe ID of the created folder.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

update-folder​

Update folder.

Renames or moves a folder in a draft changeset. Read it with get-resource first and pass its baseVersion. folderPath identifies the parent folder. Provide contentPackId for pack-owned folders.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
namestringOptionalMust not be empty. At most 256 characters.
folderPathstringOptional
baseVersionintegerOptional
folderIdstringRequiredThe ID of the folder to update. Pattern: ^FLD_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
contentPackIdstringOptionalPattern: ^PAK_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
folderobject (two variants)
folder[variant 1].idstringPattern: ^FLD_[A-Z0-9]{1,7}$.
folder[variant 1].namestringThe folder name.
folder[variant 1].organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
folder[variant 1].spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
folder[variant 1].createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
folder[variant 1].createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
folder[variant 1].updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
folder[variant 1].updatedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
folder[variant 1].parentFolderIdstringMay be null. Pattern: ^FLD_[A-Z0-9]{1,7}$.
folder[variant 1].folderPathstring
folder[variant 1].readOnlyboolean
folder[variant 1].installedFromobject (two variants)May be null.
folder[variant 1].installedFrom[variant 1].linkModeenumOne of Manual, Automatic.
folder[variant 1].installedFrom[variant 1].installationIdstringMay be null. Pattern: ^PKI_[A-Z0-9]{1,7}$.
folder[variant 1].installedFrom[variant 1].templateIdstring
folder[variant 1].installedFrom[variant 1].contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
folder[variant 1].installedFrom[variant 2].linkModeenumOne of Copy.
folder[variant 1].installedFrom[variant 2].contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
folder[variant 1].versionintegerMay be null. Greater than 0.
folder[variant 1].deletedbooleanDefaults to false.
folder[variant 1].changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
folder[variant 1].changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
folder[variant 1].originKeystringMay be null.
folder[variant 2].idstringPattern: ^FLD_[A-Z0-9]{1,7}$.
folder[variant 2].namestringThe folder name.
folder[variant 2].organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
folder[variant 2].createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
folder[variant 2].createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
folder[variant 2].updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
folder[variant 2].updatedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
folder[variant 2].parentFolderIdstringMay be null. Pattern: ^FLD_[A-Z0-9]{1,7}$.
folder[variant 2].folderPathstring
folder[variant 2].versionintegerMay be null. Greater than 0.
folder[variant 2].deletedbooleanDefaults to false.
folder[variant 2].changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
folder[variant 2].changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
folder[variant 2].originKeystringMay be null.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

delete-folder​

Delete folder.

Deletes an empty folder in a draft changeset. Read it with get-resource first and pass its baseVersion. Provide contentPackId for pack-owned content. Move or delete its children first; this tool does not recursively delete content.

Annotations: readOnlyHint false, destructiveHint true, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
folderIdstringRequiredThe ID of the folder to delete. Pattern: ^FLD_[A-Z0-9]{1,7}$.
contentPackIdstringOptionalPattern: ^PAK_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
baseVersionintegerOptional

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

get-content-work-item​

Get content work item details.

Retrieves the complete details of a specific content work item by ID, including its name, description, status, and assignment information.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

FieldTypeRequiredDescription
workItemIdstringRequiredThe ID of the content work item to retrieve.

Outputs​

FieldTypeDescription
workItemobject
workItem.idstringPattern: ^CWI_[A-Z0-9]{1,7}$.
workItem.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
workItem.spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
workItem.namestring
workItem.descriptionstring
workItem.statusenumOne of Open, Done, Cancelled.
workItem.assignedToUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
workItem.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
workItem.createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
workItem.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
workItem.updatedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
workItem.implementationSkippedReasonenumOne of QuotaExceeded. May be null.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

get-resource​

Get resource.

Fetch a content or dataset resource by ID. The resource type is inferred from the ID prefix (e.g. TBL_ for tables, LKP_ for lookups, INT_ for integrations). Optionally read a draft version from a changeset.

Large resources: read a summary first. Dashboards with many panels, MCP configs with many discovered tools, and detections or parsers with long queries can be far too large to read whole — a big dashboard exceeds the tool-result limit on its own, and the result is then cut off mid-resource.

Use detail to control what comes back:

  • full (default) — the whole resource. Right for small resources.
  • summary — large fields are replaced by their size, and every sub-item is listed by its identifying field (a panel's id, a discovered MCP tool's name) along with its remaining small fields. That identifier is what goes in fields: ["<field>[<id>]"]. Use this to find the sub-item you want.
  • fields — summary plus what you name in fields. Name an elided scalar field ("query") or one sub-item ("panels[panel-3]"). Sub-item arrays must be addressed one item at a time: a bare "panels" expands nothing, and the result's partial-read note tells you to address one item instead.

To edit one panel of a dashboard: call with detail: "summary" to list the panels and their ids, then call again with detail: "fields" and fields: ["panels[<id>]"] to read that panel's query and spec, then patch it with update-dashboard-panels. Do NOT read a large dashboard at full detail just to find a panel id.

fields names at most 6 entries per call, matching what update-dashboard-panels accepts. Entries that match no field or sub-item are reported in the result's partial-read note rather than failing the call.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

FieldTypeRequiredDescription
resourceIdstringRequired
detailenumOptionalOne of full, summary, fields.
fieldsarray of stringOptional
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
resourceobject (17 variants)
contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
projectionobject
projection.detailenumOne of full, summary, fields.
projection.unknownFieldsarray of string
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

search-resources​

Search resources.

Searches the organization's resources by name or ID: every content kind (currently Folders, Detections, Dashboards, Integrations, Lookups, Webhooks, HTTP Tools, MCP Servers, Skills), every dataset kind (Tables, Views, Unions, Connectors), Cases, Threat Reports, and Content Work Items. Set contentPackId to search within one content pack, including its current changeset overlay.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

FieldTypeRequiredDescription
querystringRequiredThe query string to search for.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
contentPackIdstringOptionalPattern: ^PAK_[A-Z0-9]{1,7}$.
limitintegerOptionalGreater than 0. Maximum 50. Defaults to 10.

Outputs​

FieldTypeDescription
resultsarray of object
results[].resourceIdstringThe ID of the resource.
results[].resourceKindenumThe type of resource. One of Case, Connector, ContentWorkItem, Table, ThreatReport, Union, View, Folder, Detection, Dashboard, Integration, Lookup, WebhookConfig, HttpToolConfig, McpConfig, Skill.
results[].namestringThe name of the resource.
results[].organizationIdstringMay be null.
results[].contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
results[].updatedAtstringThe last updated timestamp.
results[].ranknumberThe search relevance rank.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

list-spaces​

List spaces.

Lists all spaces the user has access to.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

This tool takes no arguments.

Outputs​

FieldTypeDescription
spacesarray of object
spaces[].idstringThe space ID.
spaces[].namestringThe space name.
spaces[].readOnlybooleanWhether the space is read-only.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

create-content-pack​

Create content pack.

Create an organization content pack in the active draft changeset only when the user needs to share authored content across multiple spaces. For normal content in one space, create the content directly in that space instead. Use the returned content pack ID when you create integrations, parsers, mappers, or detections in the shared pack.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
namestringRequired
descriptionstringOptionalMay be null.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
contentPackobject
contentPack.idstringPattern: ^PAK_[A-Z0-9]{1,7}$.
contentPack.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
contentPack.namestring
contentPack.descriptionstringMay be null.
contentPack.releaseVersionintegerGreater than 0.
contentPack.perpetualSuppliedboolean
contentPack.previewboolean
contentPack.imageUrlstringPattern: ^/pack-images/[^/]+$.
contentPack.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
contentPack.createdByUserIdstringMay be null.
contentPack.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
contentPack.updatedByUserIdstringMay be null.
contentPack.versionintegerMay be null. Greater than 0.
contentPack.deletedbooleanDefaults to false.
contentPack.changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
contentPack.changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

update-content-pack​

Update content pack.

Update the name or description of a content pack in the active draft changeset. Content packs are for content shared across multiple spaces, not normal content authored in one space. Omit fields that must remain unchanged.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
namestringOptional
descriptionstringOptionalMay be null.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
baseVersionintegerOptional
contentPackIdstringRequiredThe ID of the content pack to update. Pattern: ^PAK_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
contentPackobject
contentPack.idstringPattern: ^PAK_[A-Z0-9]{1,7}$.
contentPack.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
contentPack.namestring
contentPack.descriptionstringMay be null.
contentPack.releaseVersionintegerGreater than 0.
contentPack.perpetualSuppliedboolean
contentPack.previewboolean
contentPack.imageUrlstringPattern: ^/pack-images/[^/]+$.
contentPack.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
contentPack.createdByUserIdstringMay be null.
contentPack.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
contentPack.updatedByUserIdstringMay be null.
contentPack.versionintegerMay be null. Greater than 0.
contentPack.deletedbooleanDefaults to false.
contentPack.changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
contentPack.changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

delete-content-pack​

Delete content pack.

Delete a content pack and its authored shared content in the active draft changeset. Content packs are for content shared across multiple spaces, not normal content authored in one space. Use this only when the user explicitly asks to delete the content pack.

Annotations: readOnlyHint false, destructiveHint true, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
contentPackIdstringRequiredThe ID of the content pack to delete. Pattern: ^PAK_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
baseVersionintegerOptional

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

list-content-packs​

List content packs.

Lists the organization's content pack catalog, including Perpetual-supplied packs, with IDs, names, and descriptions. Use filter: "contains(name,'AWS')" to find AWS packs, or filter: "name eq 'AWS'" for an exact name. Use orderby, top, and skip to sort and page through results. Pass a returned ID to get-resource to read the pack, or as contentPackId to list or search its content.

Pass changesetId to include draft changes; otherwise the active session changeset is used when present.

Content packs are organization-scoped and do not require a space.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

FieldTypeRequiredDescription
filterstringOptional
orderbystringOptional
topintegerOptionalGreater than 0. Maximum 200. Defaults to 100.
skipintegerOptionalMinimum 0. Defaults to 0.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
contentPacksarray of object
contentPacks[].idstringPattern: ^PAK_[A-Z0-9]{1,7}$.
contentPacks[].namestring
contentPacks[].descriptionstringMay be null.
totalCountintegerMinimum 0.
skipintegerMinimum 0.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

add-to-content-pack​

Add resources to content pack.

Copies existing space content into a content pack in a draft changeset. Supports folders, detections, dashboards, integrations, lookups, webhooks, HTTP tools, MCP configs, and skills. Selecting a folder copies its children into the pack root, preserving deeper nesting; the selected folder itself is not recreated. Integration children are copied too. Source resources remain in their space. All items must belong to the active space. Up to 500 selected items are copied atomically. The added count is the number of normalized selected items, not individual descendants. Use get-resource and search-resources to find source IDs and inspect the target pack first.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
contentPackIdstringRequiredPattern: ^PAK_[A-Z0-9]{1,7}$.
itemsarray of objectRequired
items[].typeenumRequiredOne of Folder, Detection, Dashboard, Integration, Lookup, WebhookConfig, HttpToolConfig, McpConfig, Skill.
items[].idstringRequiredMust not be empty.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.
spaceIdstringRequiredThe ID of the space to target for this operation. Pattern: ^SPC_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
addedintegerMinimum 0.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

install-content-pack​

Install content pack.

Stages installation of a content pack into the explicit target spaceIds in a draft changeset. Use list-spaces and list-content-packs first. Defaults to Automatic links and undeployed content. Copy mode creates independent content without an installation to update or uninstall. Supports connector creation and parser bindings for deployed integrations. Returns installation IDs and the draft changeset; does not commit.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
contentPackIdstringRequiredPattern: ^PAK_[A-Z0-9]{1,7}$.
spaceIdsarray of stringRequired
linkModeenumOptionalOne of Manual, Copy, Automatic.
installPathstringOptionalDefaults to Packs.
installDeployedbooleanOptionalDefaults to false.
deployResourceTypesarray of enumOptionalDefaults to [].
newConnectorsarray of objectOptionalDefaults to [].
newConnectors[].spaceIdstringRequiredPattern: ^SPC_[A-Z0-9]{1,7}$.
newConnectors[].namestringRequiredConstrained by a pattern; see the schema in tools/list.
newConnectors[].typeenumRequiredOne of ObjectStorageConnector, ApiPollingConnector, StreamingConnector, HttpSourceConnector.
newConnectors[].configobject (four variants)Required
newConnectors[].config[ObjectStorageConnector].typestringRequiredAlways ObjectStorageConnector.
newConnectors[].config[ObjectStorageConnector].initialLookbackDaysintegerOptionalGreater than 0. Defaults to 14.
newConnectors[].config[ObjectStorageConnector].scanIntervalMinutesintegerOptionalMinimum 5.
newConnectors[].config[ObjectStorageConnector].bucketstringRequiredConstrained by a pattern; see the schema in tools/list. At most 63 characters.
newConnectors[].config[ObjectStorageConnector].prefixstringRequired
newConnectors[].config[ObjectStorageConnector].regionstringOptionalDefaults to not-used.
newConnectors[].config[ObjectStorageConnector].manageBucketNotificationsbooleanOptional
newConnectors[].config[ObjectStorageConnector].objectStoreobjectRequiredNested fields omitted; see the schema in tools/list.
newConnectors[].config[ApiPollingConnector].typestringRequiredAlways ApiPollingConnector.
newConnectors[].config[ApiPollingConnector].connectorKindstringRequiredCatalog connector kind (e.g. "google-workspace", "gcp-pubsub") or "custom" for a customer ECR image. Must not be empty.
newConnectors[].config[ApiPollingConnector].credentialIdsmap of stringOptional
newConnectors[].config[ApiPollingConnector].intervalMinutesintegerRequiredMinimum 1.
newConnectors[].config[ApiPollingConnector].initialLookbackDaysintegerOptionalGreater than 0.
newConnectors[].config[ApiPollingConnector].settingsobjectRequired
newConnectors[].config[ApiPollingConnector].ecrImageUrlstringOptionalECR image URL for a custom connector Lambda container. Must not be empty.
newConnectors[].config[StreamingConnector].typestringRequiredAlways StreamingConnector.
newConnectors[].config[StreamingConnector].connectorKindstringRequiredCatalog connector kind (e.g. "google-workspace", "gcp-pubsub") or "custom" for a customer ECR image. Must not be empty.
newConnectors[].config[StreamingConnector].credentialIdsmap of stringOptional
newConnectors[].config[StreamingConnector].settingsobjectRequired
newConnectors[].config[StreamingConnector].ecrImageUrlstringOptionalECR image URL for a custom connector Lambda container. Must not be empty.
newConnectors[].config[HttpSourceConnector].typestringRequiredAlways HttpSourceConnector.
newConnectors[].config[HttpSourceConnector].authModeenumRequiredOne of bearer, presigned, hmac.
newConnectors[].config[HttpSourceConnector].credentialIdstringOptionalPattern: ^CRD_[A-Z0-9]{1,7}$.
newConnectors[].clientKeystringRequiredMust not be empty.
parserBindingsarray of objectOptionalDefaults to [].
parserBindings[].spaceIdstringRequiredPattern: ^SPC_[A-Z0-9]{1,7}$.
parserBindings[].templateParserIdstringRequiredPattern: ^PRS_[A-Z0-9]{1,7}$.
parserBindings[].connectorIdsarray of stringOptional
parserBindings[].newConnectorKeysarray of stringOptional
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
resultsarray of object
results[].spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
results[].installationobjectMay be null.
results[].installation.idstringPattern: ^PKI_[A-Z0-9]{1,7}$.
results[].installation.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
results[].installation.spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
results[].installation.contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
results[].installation.namestring
results[].installation.installedReleaseVersionintegerGreater than 0.
results[].installation.linkModeenumOne of Manual, Copy, Automatic.
results[].installation.installFolderIdstringFolder this installation installed its content into. It carries no installedFrom; identify the install folder by this id. Pattern: ^FLD_[A-Z0-9]{1,7}$.
results[].installation.installDeployedboolean
results[].installation.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
results[].installation.createdByUserIdstringMay be null.
results[].installation.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
results[].installation.updatedByUserIdstringMay be null.
results[].installation.versionintegerMay be null. Greater than 0.
results[].installation.deletedbooleanDefaults to false.
results[].installation.changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
results[].installation.changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
results[].installation.installFolderPathstring
results[].installation.draftChangesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
results[].installation.packReleaseVersionintegerGreater than 0.
results[].installation.perpetualSuppliedboolean
results[].installFolderIdstringFolder this installation installed its content into. It carries no installedFrom; identify the install folder by this id. Pattern: ^FLD_[A-Z0-9]{1,7}$.
changesetobject
changeset.idstringPattern: ^CHG_[A-Z0-9]{1,7}$.
changeset.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
changeset.namestringMay be null.
changeset.descriptionstringMay be null.
changeset.statusenumOne of draft, proposed, committed, declined.
changeset.createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.committedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.committedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.declinedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.declinedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdByChatIdstringMay be null. Pattern: ^CHT_[A-Z0-9]{1,7}$.
createdConnectorsarray of objectDefaults to [].
createdConnectors[].clientKeystringMust not be empty.
createdConnectors[].idstringPattern: ^CON_[A-Z0-9]{1,7}$.
createdConnectors[].generatedSecretstringMust not be empty.
createdConnectors[].generatedIngestUrlstringFormat: uri.
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

list-content-pack-installations​

List content pack installations.

Lists content pack installations with IDs, target spaces, link modes, versions, and pending status. Optionally filter by contentPackId or OData fields. Restricts to the active space when one is selected; otherwise lists accessible installations across spaces. Pass changesetId to include staged changes.

Annotations: readOnlyHint true, idempotentHint true.

Inputs​

FieldTypeRequiredDescription
filterstringOptional
orderbystringOptional
topintegerOptionalGreater than 0. Maximum 200. Defaults to 100.
skipintegerOptionalMinimum 0. Defaults to 0.
contentPackIdstringOptionalPattern: ^PAK_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
installationsarray of object
installations[].idstringPattern: ^PKI_[A-Z0-9]{1,7}$.
installations[].organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
installations[].spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
installations[].contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
installations[].namestring
installations[].installedReleaseVersionintegerGreater than 0.
installations[].linkModeenumOne of Manual, Copy, Automatic.
installations[].installFolderIdstringFolder this installation installed its content into. It carries no installedFrom; identify the install folder by this id. Pattern: ^FLD_[A-Z0-9]{1,7}$.
installations[].installDeployedboolean
installations[].createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
installations[].createdByUserIdstringMay be null.
installations[].updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
installations[].updatedByUserIdstringMay be null.
installations[].versionintegerMay be null. Greater than 0.
installations[].deletedbooleanDefaults to false.
installations[].changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
installations[].changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
installations[].installFolderPathstring
installations[].draftChangesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
installations[].packReleaseVersionintegerGreater than 0.
installations[].perpetualSuppliedboolean
totalCountintegerMinimum 0.
skipintegerMinimum 0.
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

update-content-pack-installation​

Update content pack installation.

Stages an update of a linked installation to its current pack version. Use list-content-pack-installations to find the installationId. Uses an explicit or active draft changeset, creating one if needed. Does not commit, delete an entire changeset, or operate on Copy-mode installs.

Annotations: readOnlyHint false, destructiveHint false, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
installationIdstringRequiredPattern: ^PKI_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetobjectMay be null.
changeset.idstringPattern: ^CHG_[A-Z0-9]{1,7}$.
changeset.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
changeset.namestringMay be null.
changeset.descriptionstringMay be null.
changeset.statusenumOne of draft, proposed, committed, declined.
changeset.createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.committedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.committedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.declinedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.declinedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdByChatIdstringMay be null. Pattern: ^CHT_[A-Z0-9]{1,7}$.
installationobject
installation.idstringPattern: ^PKI_[A-Z0-9]{1,7}$.
installation.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
installation.spaceIdstringPattern: ^SPC_[A-Z0-9]{1,7}$.
installation.contentPackIdstringPattern: ^PAK_[A-Z0-9]{1,7}$.
installation.namestring
installation.installedReleaseVersionintegerGreater than 0.
installation.linkModeenumOne of Manual, Copy, Automatic.
installation.installFolderIdstringFolder this installation installed its content into. It carries no installedFrom; identify the install folder by this id. Pattern: ^FLD_[A-Z0-9]{1,7}$.
installation.installDeployedboolean
installation.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
installation.createdByUserIdstringMay be null.
installation.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
installation.updatedByUserIdstringMay be null.
installation.versionintegerMay be null. Greater than 0.
installation.deletedbooleanDefaults to false.
installation.changesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
installation.changesetStatusenumOne of Unchanged, Added, Modified, Deleted. May be null.
installation.installFolderPathstring
installation.draftChangesetIdstringMay be null. Pattern: ^CHG_[A-Z0-9]{1,7}$.
installation.packReleaseVersionintegerGreater than 0.
installation.perpetualSuppliedboolean
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.

uninstall-content-pack-installation​

Uninstall content pack installation.

Stages removal of a linked content pack installation and its installed content. Use list-content-pack-installations to find the installationId. Uses an explicit or active draft changeset, creating one if needed. Does not commit, delete an entire changeset, or operate on Copy-mode installs.

Annotations: readOnlyHint false, destructiveHint true, idempotentHint false.

Inputs​

FieldTypeRequiredDescription
installationIdstringRequiredPattern: ^PKI_[A-Z0-9]{1,7}$.
changesetIdstringOptionalPattern: ^CHG_[A-Z0-9]{1,7}$.

Outputs​

FieldTypeDescription
changesetobjectMay be null.
changeset.idstringPattern: ^CHG_[A-Z0-9]{1,7}$.
changeset.organizationIdstringPattern: ^ORG_[A-Z0-9]{1,7}$.
changeset.namestringMay be null.
changeset.descriptionstringMay be null.
changeset.statusenumOne of draft, proposed, committed, declined.
changeset.createdByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.updatedAtstringJavaScript Date or other runtime timestamp in tool results. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.proposedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.committedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.committedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.declinedAtstringJavaScript Date or other runtime timestamp in tool results. May be null. Format: date-time. Constrained by a pattern; see the schema in tools/list.
changeset.declinedByUserIdstringMay be null. Pattern: ^USR_[A-Z0-9]{1,7}$.
changeset.createdByChatIdstringMay be null. Pattern: ^CHT_[A-Z0-9]{1,7}$.
changesetIdstringThe exact changeset containing this mutation. Pattern: ^CHG_[A-Z0-9]{1,7}$.
validationobject
validation.validboolean
validation.errorsarray of object
validation.errors[].resourceIdstring
validation.errors[].resourceKindstring
validation.errors[].resourceNamestring
validation.errors[].messagestring
validation.errors[].fieldstring
linksarray of object (three variants)
links[][resource].typestringAlways resource.
links[][resource].idstring
links[][resource].resourceKindenumOne of CaseAlertBlock, Alert, AiProvider, Case, CaseAnalysisBlock, CaseLogBlock, CaseNoteBlock, CaseResponseActionBlock, Changeset, Chat, Comment, Connector, ContentPack, ContentPackInstallation, ContentWorkItem, Credential, Dashboard, DataPlane, Detection, Folder, HttpToolConfig, Integration, Lookup, Mapper, McpConfig, Organization, Parser, ResourceGroup, Role, Schema, Skill, Space, Table, ThreatReport, Union, User, View, WebhookConfig.
links[][resource].linkstringCanonical URL for this result. Format: uri.
links[][changeset].typestringAlways changeset.
links[][changeset].idstring
links[][changeset].linkstringCanonical URL for this result. Format: uri.
links[][query].typestringAlways query.
links[][query].idstring
links[][query].linkstringCanonical URL for this result. Format: uri.
  • MCP access, the surface these tools are registered on.
  • Resource, the model every tool reaches.
  • Spaces, the scope a call names.