Skip to main content
POST
https://api.rotavision.com
/
dastavez
/
agents
/
{agent_id}
/
workflows
curl -X POST https://api.rotavision.com/v1/dastavez/agents/agent_xyz789/workflows \
  -H "Authorization: Bearer rv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": {
      "steps": [
        {
          "action": "navigate",
          "url": "https://services.gst.gov.in"
        },
        {
          "action": "login",
          "credentials_key": "gst_portal"
        },
        {
          "action": "wait",
          "selector": ".dashboard-loaded",
          "timeout": 10000
        },
        {
          "action": "click",
          "selector": "[data-menu=\"returns\"]"
        },
        {
          "action": "extract",
          "selector": ".returns-table tr",
          "multiple": true,
          "fields": {
            "period": "td:nth-child(1)",
            "status": "td:nth-child(2)",
            "filed_date": "td:nth-child(3)"
          }
        },
        {
          "action": "screenshot",
          "full_page": false
        }
      ]
    },
    "inputs": {
      "financial_year": "2025-26"
    }
  }'
{
  "id": "workflow_exec_123",
  "agent_id": "agent_xyz789",
  "status": "running",
  "progress": {
    "current_step": 2,
    "total_steps": 6,
    "current_action": "login"
  },
  "created_at": "2026-02-01T10:30:00Z"
}

Request

agent_id
string
required
The agent ID to run the workflow on.
workflow
object
required
Workflow definition.
inputs
object
Input variables for the workflow.
webhook_url
string
URL for completion webhook.

Step Types

ActionDescriptionParameters
navigateGo to URLurl
clickClick elementselector, wait_for
typeType textselector, text, clear
extractExtract dataselector, attribute, multiple
screenshotCapture screenfull_page, selector
downloadDownload fileselector, wait_for
waitWait for element/timeselector, timeout, duration
loginAuthenticatecredentials_key
conditionalIf/else logiccondition, then, else
loopIterateitems, steps
curl -X POST https://api.rotavision.com/v1/dastavez/agents/agent_xyz789/workflows \
  -H "Authorization: Bearer rv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": {
      "steps": [
        {
          "action": "navigate",
          "url": "https://services.gst.gov.in"
        },
        {
          "action": "login",
          "credentials_key": "gst_portal"
        },
        {
          "action": "wait",
          "selector": ".dashboard-loaded",
          "timeout": 10000
        },
        {
          "action": "click",
          "selector": "[data-menu=\"returns\"]"
        },
        {
          "action": "extract",
          "selector": ".returns-table tr",
          "multiple": true,
          "fields": {
            "period": "td:nth-child(1)",
            "status": "td:nth-child(2)",
            "filed_date": "td:nth-child(3)"
          }
        },
        {
          "action": "screenshot",
          "full_page": false
        }
      ]
    },
    "inputs": {
      "financial_year": "2025-26"
    }
  }'
{
  "id": "workflow_exec_123",
  "agent_id": "agent_xyz789",
  "status": "running",
  "progress": {
    "current_step": 2,
    "total_steps": 6,
    "current_action": "login"
  },
  "created_at": "2026-02-01T10:30:00Z"
}