Execute API Tasks

API Doc

Interactive API docs can be found at: https://run.truebit.network/dispatcher/api-docs/

Overview

You can configure the endpoint for either a synchronous or asynchronous response. In sync mode, if the result is ready within 60 seconds, it will be returned immediately. If not, you'll receive an executionId, which you can use to check the result later by calling the status endpoint.

When executing an API Task, your task input will need to specify the API endpoint path, HTTP method type, and API input parameters. These parameters must match the schema defined in the API Task manifest.

Execute a API task by Id

post

https://run.truebit.network/

/task/api/execute-by-name

Execute a API task using the provided task ID. Supports both synchronous and asynchronous execution.

Header parameters

x-api-keystringRequired

API key for authentication.

Body

application/json

namespacestringRequired

The namespace of the task.

taskNamestringRequired

The name of the task to be executed.

labelstringOptional

Label of the task.

versioninteger · uint32Optional

Version number of the task.

asyncbooleanRequired

If true, the endpoint will retrieve the executionId; otherwise, it will try to return the execution result only if it completes within 60 seconds.

inputobjectRequired

Input data required for task execution.

executionTimeoutinteger · uint32Required

Timeout for task execution in seconds.

Responses

200

Successful execution

application/json

Responseone of

or

400

Bad request, invalid input.

application/json

401

Not authorized.

application/json

402

Payment required.

application/json

500

Internal server error.

application/json

post

/task/api/execute-by-name

HTTPcURLJavaScriptPython

POST /task/api/execute-by-name HTTP/1.1
Host: run.truebit.network
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "namespace": "namespacetest",
  "taskName": "tasktestapi",
  "input": {},
  "executionTimeout": 10000,
  "async": true
}

Api task async executionApi task sync executionApi task sync execution with labelApi task sync execution with version

{
  "executionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeee",
  "clearTextSolution": {
    "output": {},
    "status": "succeed",
    "senderAddress": "0x************************************2266"
  },
  "status": "Success",
  "totalTransferredBytes": {
    "request": 194,
    "response": 438
  }
}

Authorization

API KEY

To get authorization to execute a task, include your registered API key in the request header. This allows Truebit to validate your access and identify the account responsible for covering the task execution cost (linked to the API key’s associated address).

Example

X-API-KEY: be0dc6ba-9a60-4777-b5b7-60ed2397e3ed