Dags

Get DAG by object ID

Required API-key scope: dags:read.

get /dags/{dag_object_id}

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Path Parameters

dag_object_id string required

DAG object id

200application/json

DAG detail

created_at string required

creator string required

finalized_at string | null

When DAGFinalizedEvent sealed the DAG. Null means it is still being built and cannot be executed.

object_id string required

onchain_created_at string | null

Checkpoint timestamp of the on-chain creation event; null for rows projected before on-chain timestamps were indexed (until a backfill + replay fills them).

updated_at string required

404

DAG was not found

500

Internal server error

Get DAG by object ID

curl --request GET \
  --url https://api-testnet.taluslabs.dev/dags/<dag_object_id> \
  --header 'x-api-key: <api-key>'

const response = await fetch('https://api-testnet.taluslabs.dev/dags/<dag_object_id>', {
  method: 'GET',
  headers: {
    'x-api-key': '<api-key>'
  },
});

const data = await response.json();
console.log(data);

import requests

url = "https://api-testnet.taluslabs.dev/dags/<dag_object_id>"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.json())

200

{
  "created_at": "<string>",
  "creator": "<string>",
  "finalized_at": "<string>",
  "object_id": "<string>",
  "onchain_created_at": "<string>",
  "updated_at": "<string>"
}

DAG was not found

Internal server error

On this page

Authorizations
Path Parameters
200 response
404 response
500 response

getGet DAG by object ID

get /dags/{dag_object_id}

Authorization

x-api-key string required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Path

dag_object_id string required

DAG object id

Get DAG by object ID

curl --request GET \
  --url https://api-testnet.taluslabs.dev/dags/<dag_object_id> \
  --header 'x-api-key: <api-key>'

const response = await fetch('https://api-testnet.taluslabs.dev/dags/<dag_object_id>', {
  method: 'GET',
  headers: {
    'x-api-key': '<api-key>'
  },
});

const data = await response.json();
console.log(data);

import requests

url = "https://api-testnet.taluslabs.dev/dags/<dag_object_id>"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.json())

Response

Send the request to see the live response.