Get Response

curl -X GET 'https://api.narada.ai/fast/v2/remote-dispatch/responses/req_abc123def456' \
  -H 'x-api-key: YOUR_API_KEY'

const response = await fetch(
  `https://api.narada.ai/fast/v2/remote-dispatch/responses/${requestId}`,
  {
    headers: {
      "x-api-key": process.env.NARADA_API_KEY,
    },
  }
);

const data = await response.json();
console.log(data); // { "status": "success", "response": { "output": { "type": "text", "content": "Successfully clicked on Insurance header..." } }, "createdAt": "...", "completedAt": "..." }

import requests
import os

response = requests.get(
  f'https://api.narada.ai/fast/v2/remote-dispatch/responses/{request_id}',
  headers={'x-api-key': os.getenv('NARADA_API_KEY')}
)

data = response.json()
print(data) # { "status": "success", "response": { "output": { "type": "text", "content": "Successfully clicked on Insurance header..." } }, "createdAt": "...", "completedAt": "..." }

{
  "status": "pending",
  "response": null,
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": null
}

{
  "status": "success",
  "response": {
    "output": {
      "type": "text",
      "content": "Successfully clicked on Insurance header and navigated to the insurance section"
    },
    "actionTrace": [
      {
        "url": "https://example.com",
        "action": "Clicked the Insurance header",
        "startTs": "2026-07-20T17:00:00.000Z",
        "endTs": "2026-07-20T17:00:01.500Z",
        "durationMs": 1500
      },
      {
        "url": "https://example.com/insurance",
        "action": "Opened the Claims section",
        "startTs": "2026-07-20T17:00:02.000Z",
        "endTs": "2026-07-20T17:00:02.800Z",
        "durationMs": 800
      },
      {
        "url": "https://example.com/insurance",
        "action": "Done: Successfully clicked on Insurance header and navigated to the insurance section",
        "credits": 0.0,
        "startTs": "2026-07-20T17:00:03.000Z",
        "endTs": "2026-07-20T17:00:03.600Z",
        "durationMs": 600
      }
    ]
  },
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": "2024-12-19T00:00:30.000000+00:00"
}

{
  "status": "error",
  "response": null,
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": "2024-12-19T00:00:30.000000+00:00"
}

{
  "status": "input-required",
  "response": {
    "output": {
      "type": "text",
      "content": "The operation could not be completed without additional user input."
    }
  },
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": null
}

Use this endpoint to poll for the completion status and results of a previously submitted automation task. This is an alternative to using webhooks for receiving task results.

Authorization

string

required

Your Narada API key for authentication. Must be the same key used to create the original task.

Path Parameters

string

required

The unique identifier returned from the Remote Dispatch API when the task was created.

Response

string

required

Current status of the automation task. Possible values:

"pending" - Task is still running
"success" - Task completed successfully
"error" - Task failed with an error
"input-required" - Task requires additional user input to continue

string | null

The browser window ID where the task was executed. null if not applicable.

object | null

Task response data. null when status is "pending".

Show Response Object Properties

object

The agent’s output. Either a text response or structured data, depending on whether responseFormat was provided:

{ type: "text", content: string }
| { type: "structured", content: object }

array | null

A detailed log of every action the agent took during execution. See Action Trace for the complete format.

string

deprecated

Deprecated. Use output.content instead.

object | null

deprecated

Deprecated. Use output.content instead (when output.type is "structured"). See Structured Output for details.

string

required

ISO 8601 timestamp when the task was initially created.

string | null

ISO 8601 timestamp when the task completed. null if still pending.

object | null

Usage statistics for the task. null if not yet available.

Show Usage Object Properties

integer

Number of actions performed during execution.

number

Credits consumed by the task.

Response Handling Options

This endpoint provides synchronous access to task results. For production applications, consider these alternatives:

Webhooks (Recommended)

Receive real-time notifications when tasks complete. More efficient and scalable than polling.

Polling Implementation

Complete polling implementation examples with error handling and best practices.

Rate Limiting: Implement reasonable polling intervals (5-10 seconds) to avoid overwhelming the API. Use exponential backoff for production applications.

Comparison: Polling vs Webhooks

Feature	Polling	Webhooks
Setup Complexity	Low	Medium
Real-time Updates	No (delayed by interval)	Yes
Resource Usage	Higher (active requests)	Lower
Reliability	Medium	High (with retries)
Firewall Friendly	Yes	Requires open ports

runExecute automation tasks using the Narada Python SDK

curl -X GET 'https://api.narada.ai/fast/v2/remote-dispatch/responses/req_abc123def456' \
  -H 'x-api-key: YOUR_API_KEY'

const response = await fetch(
  `https://api.narada.ai/fast/v2/remote-dispatch/responses/${requestId}`,
  {
    headers: {
      "x-api-key": process.env.NARADA_API_KEY,
    },
  }
);

const data = await response.json();
console.log(data); // { "status": "success", "response": { "output": { "type": "text", "content": "Successfully clicked on Insurance header..." } }, "createdAt": "...", "completedAt": "..." }

import requests
import os

response = requests.get(
  f'https://api.narada.ai/fast/v2/remote-dispatch/responses/{request_id}',
  headers={'x-api-key': os.getenv('NARADA_API_KEY')}
)

data = response.json()
print(data) # { "status": "success", "response": { "output": { "type": "text", "content": "Successfully clicked on Insurance header..." } }, "createdAt": "...", "completedAt": "..." }

{
  "status": "pending",
  "response": null,
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": null
}

{
  "status": "success",
  "response": {
    "output": {
      "type": "text",
      "content": "Successfully clicked on Insurance header and navigated to the insurance section"
    },
    "actionTrace": [
      {
        "url": "https://example.com",
        "action": "Clicked the Insurance header",
        "startTs": "2026-07-20T17:00:00.000Z",
        "endTs": "2026-07-20T17:00:01.500Z",
        "durationMs": 1500
      },
      {
        "url": "https://example.com/insurance",
        "action": "Opened the Claims section",
        "startTs": "2026-07-20T17:00:02.000Z",
        "endTs": "2026-07-20T17:00:02.800Z",
        "durationMs": 800
      },
      {
        "url": "https://example.com/insurance",
        "action": "Done: Successfully clicked on Insurance header and navigated to the insurance section",
        "credits": 0.0,
        "startTs": "2026-07-20T17:00:03.000Z",
        "endTs": "2026-07-20T17:00:03.600Z",
        "durationMs": 600
      }
    ]
  },
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": "2024-12-19T00:00:30.000000+00:00"
}

{
  "status": "error",
  "response": null,
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": "2024-12-19T00:00:30.000000+00:00"
}

{
  "status": "input-required",
  "response": {
    "output": {
      "type": "text",
      "content": "The operation could not be completed without additional user input."
    }
  },
  "createdAt": "2024-12-19T00:00:00.000000+00:00",
  "completedAt": null
}

Quickstart

API Endpoints

Python SDK

Authorization

Path Parameters

Response

Response Handling Options

Webhooks (Recommended)

Polling Implementation

Comparison: Polling vs Webhooks

​Authorization

​Path Parameters

​Response

​Response Handling Options

Webhooks (Recommended)

Polling Implementation

​Comparison: Polling vs Webhooks

Authorization

Path Parameters

Response

Response Handling Options

Comparison: Polling vs Webhooks