Prompt - Directus — ContextQMD

Perform CRUD operations on Directus Collections.

create: Add new collections
read: Retrieve available collections
update: Modify existing collections
delete: Remove collections </actions>

<collection_structure>

Collection Structure

json

{
	"collection": "products",
	"meta": {
		"collection": "products",
		"icon": "inventory_2", // Any Material Symbols icons
		"note": "Main product catalog with inventory tracking", // Helpful 1 sentence description
		"color": "#6366F1", // Color shown in content module sidebar
		"singleton": false, // Single-item collections (settings, globals)
		"hidden": false, // Hide from navigation
		"accountability": "all", // Track who activity and revisions (`"all"`, `"activity"`, `null`)
		"sort_field": "sort", // Default sorting field (auto-creates if needed)
		"archive_app_filter": true, // Enable soft delete in the app
		"archive_field": "status", // Field used for archiving (status, deleted_at, etc.)
		"archive_value": "archived", // Value that marks items as archived
		"unarchive_value": "published", // Value that marks items as active
		"display_template": "{{name}} - ${{price}}",
		"versioning": false, // Enable content versioning for this collection
		"sort": 2, // Sort order for this collection
		"group": null, // Parent collection (use to group and nest collections in data model)
		"collapse": "open", // Default collection to expanded or collapsed if child collections
		"preview_url": "https://store.example.com/products/{{slug}}", // Live preview URL to view items within collection - supports using template variables
		"translations": [
			{
				"language": "en-US",
				"translation": "Products",
				"singular": "product",
				"plural": "products"
			},
			{
				"language": "es-ES",
				"translation": "Productos",
				"singular": "producto",
				"plural": "productos"
			}
		]
	}
}

</collection_structure>

<creating_collections>

Primary Keys: Use UUID primary keys (see fields tool <primary_keys> section for detailed guidance)
System Fields: Include system fields for content collections (see `` section below for complete template) unless specifically asked by user to omit them.
ALWAYS show the collection URL to the user if it is present in the result.
When creating a new collection, include both collection settings and initial fields (see fields tool for complete examples).

Basic Collection Example

json

{
	"action": "create",
	"data": [
		{
			"collection": "articles",
			"fields": [
				{
					"field": "id",
					"type": "uuid",
					"meta": { "special": ["uuid"], "hidden": true, "readonly": true, "interface": "input" },
					"schema": { "is_primary_key": true, "length": 36, "has_auto_increment": false }
				},
				{
					"field": "title",
					"type": "string",
					"meta": { "interface": "input", "required": true },
					"schema": { "is_nullable": false }
				}
			],
			"schema": {}, // Always send empty object for new collection unless creating a folder collection
			"meta": {
				"singleton": false,
				"display_template": "{{title}}"
			}
		}
	]
}

</creating_collections>

Complete System Fields Template

For content collections (blogs, products, pages), include these optional system fields for full CMS functionality:

json

{
	"action": "create",
	"data": [
		{
			"collection": "articles",
			"fields": [
				{
					"field": "id",
					"type": "uuid",
					"meta": {
						"hidden": true,
						"readonly": true,
						"interface": "input",
						"special": ["uuid"]
					},
					"schema": {
						"is_primary_key": true,
						"length": 36,
						"has_auto_increment": false
					}
				},
				{
					"field": "status",
					"type": "string",
					"meta": {
						"width": "full",
						"options": {
							// You might choose to customize these options based on the users request
							"choices": [
								{
									"text": "$t:published",
									"value": "published",
									"color": "var(--theme--primary)"
								},
								{
									"text": "$t:draft",
									"value": "draft",
									"color": "var(--theme--foreground)"
								},
								{
									"text": "$t:archived",
									"value": "archived",
									"color": "var(--theme--warning)"
								}
							]
						},
						"interface": "select-dropdown",
						"display": "labels",
						"display_options": {
							"showAsDot": true,
							"choices": [
								{
									"text": "$t:published",
									"value": "published",
									"color": "var(--theme--primary)",
									"foreground": "var(--theme--primary)",
									"background": "var(--theme--primary-background)"
								},
								{
									"text": "$t:draft",
									"value": "draft",
									"color": "var(--theme--foreground)",
									"foreground": "var(--theme--foreground)",
									"background": "var(--theme--background-normal)"
								},
								{
									"text": "$t:archived",
									"value": "archived",
									"color": "var(--theme--warning)",
									"foreground": "var(--theme--warning)",
									"background": "var(--theme--warning-background)"
								}
							]
						}
					},
					"schema": {
						"default_value": "draft",
						"is_nullable": false
					}
				},
				{
					"field": "sort",
					"type": "integer",
					"meta": {
						"interface": "input",
						"hidden": true
					},
					"schema": {}
				},
				{
					"field": "user_created",
					"type": "uuid",
					"meta": {
						"special": ["user-created"],
						"interface": "select-dropdown-m2o",
						"options": {
							"template": "{{avatar}} {{first_name}} {{last_name}}"
						},
						"display": "user",
						"readonly": true,
						"hidden": true,
						"width": "half"
					},
					"schema": {}
				},
				{
					"field": "date_created",
					"type": "timestamp",
					"meta": {
						"special": ["date-created"],
						"interface": "datetime",
						"readonly": true,
						"hidden": true,
						"width": "half",
						"display": "datetime",
						"display_options": {
							"relative": true
						}
					},
					"schema": {}
				},
				{
					"field": "user_updated",
					"type": "uuid",
					"meta": {
						"special": ["user-updated"],
						"interface": "select-dropdown-m2o",
						"options": {
							"template": "{{avatar}} {{first_name}} {{last_name}}"
						},
						"display": "user",
						"readonly": true,
						"hidden": true,
						"width": "half"
					},
					"schema": {}
				},
				{
					"field": "date_updated",
					"type": "timestamp",
					"meta": {
						"special": ["date-updated"],
						"interface": "datetime",
						"readonly": true,
						"hidden": true,
						"width": "half",
						"display": "datetime",
						"display_options": {
							"relative": true
						}
					},
					"schema": {}
				}
			],
			"schema": {}, // Always send empty object for new collection unless creating a folder collection
			"meta": {
				"sort_field": "sort",
				"archive_field": "status",
				"archive_value": "archived",
				"unarchive_value": "draft",
				"singleton": false
			}
		}
	]
}

System Fields Explained:

status - Content workflow (draft/published/archived) with visual indicators
sort - Manual ordering capability (used with sort_field in collection meta)
user_created/user_updated - Track content authors and editors (requires relations to directus_users)
date_created/date_updated - Automatic timestamps for content lifecycle tracking

Required Relations for User Fields: After creating the collection, add relations for user tracking fields (use relations tool):

json

// User created relation
{
	"action": "create",
	"data": {
		"collection": "articles",
		"field": "user_created",
		"related_collection": "directus_users",
		"schema": {}
	}
}

// User updated relation
{
	"action": "create",
	"data": {
		"collection": "articles",
		"field": "user_updated",
		"related_collection": "directus_users",
		"schema": {}
	}
}

<translations> For collection name translations, check for `languages` collection first, then provide collection names in available languages (similar to field translations - see `fields` tool `<translations>` section for translation workflow).

json

{
	"meta": {
		"translations": [
			{ "language": "en-US", "translation": "Products", "singular": "product", "plural": "products" },
			{ "language": "es-ES", "translation": "Productos", "singular": "producto", "plural": "productos" }
		]
	}
}

</translations>

<display_templates>

Control how collection items appear in relationships and lists:

json

{
	"meta": {
		"display_template": "{{name}} - {{category}} ({{status}})"
	}
}

Template Variables:

{{field_name}} - Any field from the collection
{{field_name.nested}} - Access nested object properties </display_templates>