Back to Mastra

Deployment | v1 Migration Guide

docs/src/content/en/guides/migrations/upgrade-to-v1/deployment.mdx

2025-12-181.6 KB
Original Source

Deployment

The OpenAPI spec endpoint has moved to /api/openapi.json, and the CloudflareDeployer configuration has been updated to use standard wrangler.json property names.

Changed

OpenAPI spec endpoint moved to /api/openapi.json

The OpenAPI specification endpoint has moved from /openapi.json to /api/openapi.json to align with the /api prefix used by all built-in Mastra routes.

If you have scripts or tools that consume the OpenAPI spec, update the URL:

diff
- GET /openapi.json
+ GET /api/openapi.json

CloudflareDeployer uses standard wrangler.json property names

The CloudflareDeployer constructor now accepts standard wrangler.json property names instead of custom camelCase variants. This change aligns the deployer with Cloudflare's official configuration format and provides access to all wrangler configuration options.

Deprecated fields are automatically migrated at runtime with console warnings, but you should update your code to use the new field names.

diff
  const deployer = new CloudflareDeployer({
-   projectName: 'my-worker',
+   name: 'my-worker',
-   d1Databases: [
+   d1_databases: [
      {
        binding: 'DB',
        database_name: 'my-db',
        database_id: 'xxx',
      },
    ],
-   kvNamespaces: [
+   kv_namespaces: [
      {
        binding: 'KV',
        id: 'yyy',
      },
    ],
  });

The workerNamespace field has been removed as it's no longer used.

For all available configuration options, see the Wrangler configuration documentation.