Support CenterHow-ToTrigger a Manual Run
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

AspectBehavior
BillingUses subscription or check balance
ResultsStored in history
AlertsTrigger on status change
SchedulingDoes NOT reset next_run_at
Rate limitFree: 10/day, Paid: unlimited
Tagtrigger_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 }}"

Need more help?

Our support team is available to assist you

Contact Support