Apply a YAML manifest to create resources.

Creates all resources defined in the manifest file in dependency order.

Modes:

• create_only (default) — fails if any resource already exists.
• create_missing — creates what is missing, leaves what exists alone, and resolves manifest references against the resources ALREADY in the namespace. This is what makes "here is a namespace with buckets, add these collections over them" work. Under create_only a reference to an undeclared-but-existing bucket is a validation error, because the manifest is treated as a closed world.

Plan first: before creating anything, apply runs the same checks as POST /v1/manifest/validate. Any error refuses the whole manifest with success: false, every resource skipped, and each error naming the resource, the field and the fix. Nothing is created. A namespace budget above the organization's bound is set to the bound and reported as a warning.

Features:

• Topological sorting ensures resources are created in correct dependency order
• Secret references (${{ secrets.NAME }}) are resolved from organization secrets
• Atomic operation: rolls back all created resources if any creation fails, and an apply whose process is stopped part way is rolled back when the API starts again
• Dry run returns the plan without making changes

Example:

curl -X POST /v1/manifest/apply \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Namespace: ns_xxx" \
  -F "manifest_file=@mixpeek.yaml"

Example manifest:

version: "1.0"
metadata:
  name: "my-environment"

namespaces:
  - name: video_search
    feature_extractors:
      - name: multimodal_extractor
        version: v1

buckets:
  - name: raw_videos
    namespace: video_search
    schema:
      properties:
        video: { type: video }

{
  "created_count": 2,
  "dry_run": false,
  "errors": [],
  "failed_count": 0,
  "resources": [
    {
      "name": "video_search",
      "resource_id": "ns_abc123",
      "resource_type": "namespace",
      "status": "created"
    },
    {
      "name": "raw_videos",
      "resource_id": "bkt_xyz789",
      "resource_type": "bucket",
      "status": "created"
    }
  ],
  "rollback_performed": false,
  "skipped_count": 0,
  "success": true
}