write-script-graphql

Write a standard GraphQL query with typed variables, such as query GetUser($id: ID!), and save it as a script file. Windmill automatically binds script arguments to the query variables, so declared parameters become query inputs without extra code.

Declare variables in the query signature, for example $query: String! or $limit: Int = 10 with a default value. Windmill passes script arguments directly as these variables, so supplying arguments at preview or run time populates the query automatically.

wmill script preview executes the local script file without deploying, making it the default for iterating on edits. wmill script run executes the version already deployed in the workspace and should only be used when you explicitly want to test the deployed version.

Yes, mutations are supported with the same variable binding as queries. Define a mutation such as mutation CreateUser($input: CreateUserInput!) and pass the input object as a script argument to create or update data through the GraphQL API.

Use wmill sync push only when you explicitly want to deploy, publish, or push local changes to the workspace. It overwrites the workspace version, so testing local edits should always use wmill script preview instead of pushing first.