Back to How-To
Trigger a Manual Run
Run a validation check on-demand without waiting for the schedule.
When to Use
- After deploying changes
- While debugging
- To verify a fix
- Before going live
From Dashboard
Click "Run Now" on your agent. Results in 10-30 seconds.
From API
curl -X POST "https://api.agentstatus.dev/api/v1/agents/{agent_id}/run" \
-H "Authorization: Bearer YOUR_API_KEY"
Poll for Results
curl "https://api.agentstatus.dev/api/v1/runs/{decision_id}" \
-H "Authorization: Bearer YOUR_API_KEY"
Behavior
| Aspect | Behavior |
|---|---|
| Billing | Uses subscription or check balance |
| Results | Stored in history |
| Alerts | Trigger on status change |
| Scheduling | Does NOT reset next_run_at |
| Rate limit | Free: 10/day, Paid: unlimited |
| Tag | trigger_type: "manual" |
CI/CD Example
- name: Verify Agent
run: |
curl -s -X POST \
"https://api.agentstatus.dev/api/v1/agents/${{ secrets.AGENT_ID }}/run" \
-H "Authorization: Bearer ${{ secrets.AGENTSTATUS_API_KEY }}"