Set machine when triggering docs

triggerdotdev · Feb 11, 2025 · a50b93f · a50b93f
1 parent d4043fc
commit a50b93f
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/machines.mdx b/docs/machines.mdx
@@ -26,6 +26,16 @@ export const config: TriggerConfig = {
 };
 ```
 
+## Overriding the machine when triggering
+
+You can also override the task machine when you [trigger](/triggering) it:
+
+```ts
+await tasks.trigger<typeof heavyTask>("heavy-task", { message: "hello world" }, { machine: "large-2x" });
+```
+
+This is useful when you know that a certain payload will require more memory than the default machine. For example, you know it's a larger file or a customer that has a lot of data.
+
 ## Out Of Memory errors
 
 Sometimes you might see one of your runs fail with an "Out Of Memory" error.