Read or tail a setup run's log

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "lines": [
    {
      "at": "2026-02-18T09:30:00.000Z",
      "line": 1,
      "seq": 1,
      "stream": "example",
      "text": "example"
    }
  ],
  "next_after": 1,
  "status": "example",
  "truncated": true
}

{
  "code": "invalid_request",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "managed_agents_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Environments

Read or tail a setup run's log

Returns the run’s output after a cursor: stdout and stderr as the script produced them, marker lines naming each script line before it runs, and system lines for the setup phases around the script (provision, gpu_check, profile, cleanup). Secrets are redacted before storage. To tail a live run, loop with after=next_after and wait_seconds=0, sleeping two seconds client-side, until status is terminal and a page comes back empty.

GET

managed-agents

environments

{environment_id}

setup-runs

{setup_run_id}

log

Read or tail a setup run's log

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/environments/{environment_id}/setup-runs/{setup_run_id}/log")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "lines": [
    {
      "at": "2026-02-18T09:30:00.000Z",
      "line": 1,
      "seq": 1,
      "stream": "example",
      "text": "example"
    }
  ],
  "next_after": 1,
  "status": "example",
  "truncated": true
}

{
  "code": "invalid_request",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "unauthorized",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "not_found",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "rate_limit_exceeded",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "internal_error",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "managed_agents_unavailable",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {
    "field": "<string>",
    "issues": [
      "<string>"
    ],
    "requestId": "<string>",
    "retryable": true
  }
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Path Parameters

environment_id

string<uuid>

required

Environment id (UUID).

setup_run_id

string<uuid>

required

Setup run id.

Query Parameters

after

integer<int64>

Return lines with seq greater than this. Pass the previous response's next_after to continue a tail; 0 (the default) starts from the beginning.

Required range: x >= 0

limit

integer

Maximum lines to return. Defaults to 500.

Required range: 1 <= x <= 2000

wait_seconds

integer

When no new lines exist and the run is still going, block up to this many seconds for more before responding. The server caps the wait at 5 seconds; larger values are accepted and clamped. Through the public API, prefer wait_seconds=0, sleep two seconds client-side, and loop with after=next_after until status is terminal.

Required range: 0 <= x <= 60

Response

A page of a setup run's log with the cursor for the next page. stdout, stderr, marker (the script line about to run), and system (setup phase notes) are interleaved in capture order.

lines

object[]

required

Log lines after the requested cursor, in order. Empty when the run has produced nothing new within the wait.

Show child attributes

next_after

integer<int64>

required

Cursor to pass as after on the next call. Equal to the request's after when no new lines were returned.

status

string

required

The run's status when the page was read. Stop tailing once it is succeeded, failed, or cancelled and the page is empty.

truncated

boolean

True when the run produced more output than is kept (4 MiB). The head is retained; the stderr tail is on the run.

API reference

Endpoints

Read or tail a setup run's log

Authorizations

Path Parameters

Query Parameters

Response