---
title: "Manually trigger a run"
method: POST
path: "/scheduled-agents/{id}/trigger"
tags: ["Scheduled agents"]
---

# Manually trigger a run

`POST /scheduled-agents/{id}/trigger`

## Headers

- `Idempotency-Key` string

## Response `202`

{ runId }.

## Other responses

- `402` — SUBSCRIPTION_REQUIRED (upgrade-plan handoff).
- `409` — RUN_ALREADY_ACTIVE.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)