Define Mutation Functions

Blitz mutations are plain, asynchronous Javascript functions that always run on the server.

1. Mutations must be inside a mutations folder. All of the following are valid:

  • app/mutations/createProject.ts
  • app/projects/mutations/createProject.ts
  • app/admin/projects/mutations/createProject.ts

2. Mutations must export a function as the default export

You can write any normal Node.js code here, including database access and fetching from third-party APIs.

Arguments

  • input: any
    • The first argument is anything you need for your mutation. There are no special requirements.
  • ctx: Record<any, unknown>
    • This context object is automatically provided by Blitz at run time. This is used by HTTP Middleware to provide data or functions to your mutation. For example, authentication middleware can provide ctx.session with all the data about the current user session.

Example Mutation

// app/products/mutations/createProduct.tsx
import db, {ProjectCreateArgs} from "db"
type CreateProjectInput = {
data: ProjectCreateArgs["data"]
}
export default async function createProject(
{data}: CreateProjectInput,
ctx: Record<any, unknown> = {},
) {
// Can do any processing, fetching from other APIs, etc
const project = await db.project.create({data})
return project
}

We automatically alias the root of your project, so import db from 'db' is importing <project_root>/db/index.ts

Next,

read these docs to see how to use these mutations in your components.

Idea for improving this page?Edit it on Github