Skip to main content
Server path: /datastore-unstructured | Type: Embedded | PCID required: No Flexible key-value storage with no schema. Store any content type — strings, numbers, objects, arrays. Search, query with natural language, and run analytics.

​
Tools

ToolDescription
datastore-unstructured_list_collectionsList all unstructured datastore collections
datastore-unstructured_create_collectionCreate a new collection
datastore-unstructured_get_collectionGet collection details
datastore-unstructured_delete_collectionDelete a collection and all data
datastore-unstructured_list_itemsList items with pagination and sorting
datastore-unstructured_create_itemCreate or upsert an item
datastore-unstructured_batch_create_itemsCreate multiple items at once (max 500)
datastore-unstructured_get_itemGet an item by ID
datastore-unstructured_get_item_by_keyGet item(s) by key
datastore-unstructured_update_itemUpdate an existing item
datastore-unstructured_delete_itemDelete an item
datastore-unstructured_searchSearch items by text
datastore-unstructured_natural_queryQuery data using natural language
datastore-unstructured_analytics_queryRun analytics with natural language

​
datastore-unstructured_list_collections

List all unstructured datastore collections in the current workspace. Parameters: None Response fields:
FieldTypeDescription
collectionsobject[]Array of collection objects
collections[].idstringCollection ID
collections[].namestringCollection name
collections[].descriptionstringCollection description
collections[].typestringCollection type
collections[].isStructuredbooleanAlways false for unstructured collections
collections[].maxItemsnumberMaximum number of items allowed
collections[].numItemsnumberCurrent number of items
collections[].isSharedbooleanWhether the collection is shared
collections[].statusstringCollection status
collections[].createdBystringUser ID of the creator
collections[].createdByNamestringDisplay name of the creator
collections[].createdAtstringCreation timestamp
collections[].updatedAtstringLast updated timestamp

​
datastore-unstructured_create_collection

Create a new unstructured datastore collection. Parameters:
ParameterTypeRequiredDescription
namestringYesCollection name
descriptionstringNoCollection description
createdBystringYesUser ID of the creator
createdByNamestringYesDisplay name of the creator
Response fields:
FieldTypeDescription
idstringID of the newly created collection
isStructuredbooleanAlways false for unstructured collections
namestringCollection name
descriptionstringCollection description
typestringCollection type

​
datastore-unstructured_get_collection

Get details for a specific unstructured collection. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
Response fields:
FieldTypeDescription
idstringCollection ID
namestringCollection name
descriptionstringCollection description
typestringCollection type
isStructuredbooleanAlways false for unstructured collections
maxItemsnumberMaximum number of items allowed
numItemsnumberCurrent number of items
isSharedbooleanWhether the collection is shared
statusstringCollection status
createdBystringUser ID of the creator
createdByNamestringDisplay name of the creator
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

​
datastore-unstructured_delete_collection

Delete a collection and all its data. This action is irreversible. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
Response fields:
FieldTypeDescription
messagestringConfirmation message

​
datastore-unstructured_list_items

List items in a collection with pagination and sorting options. Parameters:
ParameterTypeRequiredDefaultDescription
collectionIdstringYes—Collection ID
limitnumberNo50Maximum number of items to return
offsetnumberNo—Number of items to skip for pagination
orderedBystringNo"createdAt:desc"Sort order for results
formatstringNo"light"Response format: "light" or "full"
proxyIdstringNo—Proxy ID for cross-workspace access
Response fields:
FieldTypeDescription
itemsobject[]Array of item objects
paginationobjectPagination metadata
pagination.totalCountnumberTotal number of items in the collection
pagination.hasNextPagebooleanWhether more items exist after this page
pagination.hasPrevPagebooleanWhether items exist before this page

​
datastore-unstructured_create_item

Create a new item or upsert an existing item in a collection. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
keystringYesUnique key for the item
contentstring, number, boolean, object, or arrayYesItem content — any JSON-compatible value
sortFieldstringNoCustom sort field value
metadataobjectNoAdditional metadata for the item
triggerChangesbooleanNoWhether to trigger change notifications
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
idstringID of the created item
keystringKey of the created item
messagestringSuccess message
collectionIdstringParent collection ID

​
datastore-unstructured_batch_create_items

Create multiple items at once. Maximum 500 items per batch. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
itemsobject[]YesArray of items, each with key, content, and optional metadata and sortField
triggerChangesbooleanNoWhether to trigger change notifications
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
creatednumberNumber of items successfully created
failednumberNumber of items that failed to create
messagestringSummary message

​
datastore-unstructured_get_item

Get a single item by its item ID. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
itemIdstringYesItem ID
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
idstringItem ID
keystringItem key
contentanyItem content (string, number, boolean, object, or array)
metadataobjectItem metadata
sortFieldstringSort field value
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

​
datastore-unstructured_get_item_by_key

Get one or more items by their key value. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
keystringYesItem key to look up
sortFieldstringNoSort field value to narrow results
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
itemsobject[]Array of matching items
items[].idstringItem ID
items[].keystringItem key
items[].contentanyItem content (string, number, boolean, object, or array)
items[].metadataobjectItem metadata
items[].sortFieldstringSort field value
items[].createdAtstringCreation timestamp
items[].updatedAtstringLast updated timestamp

​
datastore-unstructured_update_item

Update an existing item in a collection. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
itemIdstringYesItem ID of the item to update
contentanyYesNew content value (string, number, boolean, object, or array)
metadataobjectNoMetadata fields to update
triggerChangesbooleanNoWhether to trigger change notifications
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
idstringItem ID of the updated item
keystringItem key
messagestringSuccess message

​
datastore-unstructured_delete_item

Delete an item from a collection. Specify the item by itemId or by key (and optionally sortField). Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
itemIdstringNoItem ID of the item to delete
keystringNoKey of the item to delete (alternative to itemId)
sortFieldstringNoSort field value to narrow deletion when using key
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
messagestringConfirmation message
Search items by text with configurable matching strategy. Supports fuzzy, exact, and prefix matching across all fields or a specific field. Parameters:
ParameterTypeRequiredDefaultDescription
collectionIdstringYes—Collection ID
qstringYes—Search query text
fieldstringNo"all"Field to search: "all", "content", "sortField", or "key"
typestringNo"fuzzy"Match type: "fuzzy", "exact", or "prefix"
thresholdnumberNo0.3Fuzzy match threshold (0–1). Lower values are more permissive.
limitnumberNo50Maximum number of results
compiledbooleanNofalseWhether the query is a pre-compiled search expression
queryParamsobjectNo—Additional query parameters for compiled searches
proxyIdstringNo—Proxy ID for cross-workspace access
Response fields:
FieldTypeDescription
itemsobject[]Array of matching items
items[].idstringItem ID
items[].keystringItem key
items[].contentanyItem content
items[].scorenumberMatch relevance score
items[].snippetstringText snippet highlighting the match

​
datastore-unstructured_natural_query

Query collection data using natural language. Supports two modes: natural-search returns matching items, natural-answer returns an AI-generated answer. Parameters:
ParameterTypeRequiredDescription
collectionIdstringYesCollection ID
querystringYesNatural language query
modestringYes"natural-search" to return matching items, or "natural-answer" for an AI-generated answer. Defaults to "natural-search".
limitnumberNoMaximum number of results
offsetnumberNoNumber of results to skip for pagination
returnAllbooleanNoWhether to return all matching results
translationobjectNoTranslation configuration for the query
proxyIdstringNoProxy ID for cross-workspace access
Response fields:
FieldTypeDescription
modestringThe query mode used
itemsobject[]Array of matching items (in natural-search mode)
explanationstringExplanation of how the query was interpreted
naturalAnswerstringAI-generated answer (in natural-answer mode)
paginationobjectPagination metadata
translationobjectTranslation details if translation was requested

​
datastore-unstructured_analytics_query

Run analytics on collection data using natural language. Returns tabular results with column definitions. Parameters:
ParameterTypeRequiredDefaultDescription
collectionIdstringYes—Collection ID
querystringYes—Natural language analytics query (e.g. “count items by category”)
limitnumberNo10000Maximum number of result rows
proxyIdstringNo—Proxy ID for cross-workspace access
Response fields:
FieldTypeDescription
columnsobject[]Column definitions for the result table
rowsobject[]Result rows
totalRowsnumberTotal number of result rows
explanationstringNatural language explanation of the analytics query