microcms_get_list
Retrieve and filter a list of contents from microCMS, supporting pagination, sorting, search, and field selection for efficient data management.
Instructions
Get a list of contents from microCMS
Input Schema
Name | Required | Description | Default |
---|---|---|---|
depth | No | Depth of reference expansion (1-3) | |
draftKey | No | Draft key for preview | |
endpoint | Yes | Content type name (e.g., "blogs", "news") | |
fields | No | Comma-separated list of fields to retrieve | |
filters | No | Filter conditions | |
ids | No | Comma-separated list of content IDs | |
limit | No | Number of contents to retrieve (1-100) | |
offset | No | Offset for pagination | |
orders | No | Sort order (e.g., "-publishedAt" for descending) | |
q | No | Full-text search query |
Input Schema (JSON Schema)
{
"properties": {
"depth": {
"description": "Depth of reference expansion (1-3)",
"maximum": 3,
"minimum": 1,
"type": "number"
},
"draftKey": {
"description": "Draft key for preview",
"type": "string"
},
"endpoint": {
"description": "Content type name (e.g., \"blogs\", \"news\")",
"type": "string"
},
"fields": {
"description": "Comma-separated list of fields to retrieve",
"type": "string"
},
"filters": {
"description": "Filter conditions",
"type": "string"
},
"ids": {
"description": "Comma-separated list of content IDs",
"type": "string"
},
"limit": {
"description": "Number of contents to retrieve (1-100)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"offset": {
"description": "Offset for pagination",
"minimum": 0,
"type": "number"
},
"orders": {
"description": "Sort order (e.g., \"-publishedAt\" for descending)",
"type": "string"
},
"q": {
"description": "Full-text search query",
"type": "string"
}
},
"required": [
"endpoint"
],
"type": "object"
}