cURL

curl --request GET \
  --url https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs', 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.cwsandbox.com/v1/sandboxes/{sandboxId}/logs",
  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.cwsandbox.com/v1/sandboxes/{sandboxId}/logs"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs")

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

{
  "entries": [
    {
      "eventId": "<string>",
      "data": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "container": "<string>",
      "stream": "SANDBOX_LOG_STREAM_UNSPECIFIED"
    }
  ],
  "nextPageToken": "<string>",
  "retentionExpiresAt": "2023-11-07T05:31:56Z"
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

Get v1sandboxes logs

ListSandboxLogs returns one page of a sandbox’s stored stdout and stderr lines, ordered by (timestamp, event_id). Stored logs stay readable while the sandbox runs and after it ends, until retention_expires_at; unlike StreamLogs, a terminal sandbox is served. The creating user, or a caller with the sandbox_admin action in the sandbox’s organization, can read them. A caller who cannot see the sandbox gets the same error as GetSandbox, whether or not logs exist.

Collection is best effort: lines can be missing, for example when a sandbox ends within about a minute of writing them or when output arrives faster than it can be collected. Lines longer than the collection line limit are not stored whole. A line that is a JSON object is stored as normalized JSON: duplicate keys keep their first value, and whitespace, number formatting, and escapes are normalized. Bodies are stored as written, without redaction, so do not write secrets to stdout or stderr. Stored logs are not subject to legal hold.

Each line is stored for a fixed time after it was written, and reads end 30 days after the sandbox ends. A sandbox that ran up to 16 days keeps its full history for those 30 days; a longer sandbox keeps its full history while it runs, and afterwards its oldest lines expire first.

Pagination is keyset and weakly consistent: a line that arrives late, behind the page cursor, appears only in a new first-page request. A sandbox whose images are still being built returns an empty page.

Errors:

INVALID_ARGUMENT (CWSANDBOX_INVALID_REQUEST): a field is out of range, the container names a platform sidecar, or page_token is malformed, expired, or does not match the request.
FAILED_PRECONDITION (CWSANDBOX_LOGS_NOT_ENABLED): the sandbox has no stored logs to serve. Stored logs were not enabled for it when it was created, or are not enabled for the organization.
FAILED_PRECONDITION (CWSANDBOX_LOGS_DELETED): the sandbox’s stored logs were deleted.
FAILED_PRECONDITION (CWSANDBOX_LOG_RETENTION_EXPIRED): the stored logs are past their retention deadline.
FAILED_PRECONDITION (CWSANDBOX_LOG_QUERY_TOO_EXPENSIVE): the query exceeds a cost limit and fails the same way on retry. Narrow the time range, or remove text_contains.
RESOURCE_EXHAUSTED (CWSANDBOX_LOG_QUERY_LIMIT_EXCEEDED) with RetryInfo: too many stored-log calls are in flight, or the query met transient pressure. Retry after the delay.
UNAVAILABLE (CWSANDBOX_LOG_BACKEND_UNAVAILABLE) with RetryInfo: the stored-log backend is unavailable. Retry after the delay.
UNAVAILABLE (CWSANDBOX_FEATURE_FLAG_UNAVAILABLE): whether stored logs are enabled could not be determined. Retry later.
UNAVAILABLE (CWSANDBOX_BACKEND_UNAVAILABLE) with RetryInfo: the sandbox’s stored-log state could not be read. Retry after the delay.
UNIMPLEMENTED (CWSANDBOX_NOT_IMPLEMENTED): the deployment does not serve stored logs.

GET

sandboxes

{sandboxId}

logs

cURL

curl --request GET \
  --url https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs', 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.cwsandbox.com/v1/sandboxes/{sandboxId}/logs",
  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.cwsandbox.com/v1/sandboxes/{sandboxId}/logs"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.cwsandbox.com/v1/sandboxes/{sandboxId}/logs")

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

{
  "entries": [
    {
      "eventId": "<string>",
      "data": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "container": "<string>",
      "stream": "SANDBOX_LOG_STREAM_UNSPECIFIED"
    }
  ],
  "nextPageToken": "<string>",
  "retentionExpiresAt": "2023-11-07T05:31:56Z"
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

default:Bearer {API_ACCESS_TOKEN}

required

CoreWeave API access token sent as a bearer token.

Path Parameters

sandboxId

string

required

Query Parameters

startTime

string<date-time>

Inclusive start of the time range. Defaults to one hour before the earlier of endTime and the effective read window's end. A request covers at most 24 hours and is narrowed to the read window. That window starts five minutes before log collection began and ends five minutes after the sandbox's terminal time (or the request time for a running sandbox). A range outside that window returns no lines.

endTime

string<date-time>

Exclusive end of the time range. Defaults to just after the effective read window ends, five minutes after the sandbox terminates, or five minutes after the request time while it runs.

container

string

Container name. Empty selects every workload container. Platform sidecar names are INVALID_ARGUMENT (CWSANDBOX_INVALID_REQUEST).

stream

enum<string>

Output stream. Unspecified selects both.

Available options:

SANDBOX_LOG_STREAM_UNSPECIFIED,

SANDBOX_LOG_STREAM_STDOUT,

SANDBOX_LOG_STREAM_STDERR

textContains

string

Return only lines whose body contains this literal byte sequence (case sensitive, no wildcards). 3 to 256 bytes. Requires explicit start_time and end_time at most one hour apart.

pageSize

integer<int32>

Maximum entries per page. 0 means 100; values above 1000 are treated as 1000; negative values are INVALID_ARGUMENT. A page may hold fewer entries, so continue while next_page_token is set.

pageToken

string

nextPageToken from the previous page. Keep the time fields, container, stream, textContains, and order unchanged from the request that returned it. pageSize can change between pages. A token expires 60 minutes after it is issued.

order

enum<string>

Page order. Unspecified is ascending.

Available options:

LIST_SANDBOX_LOGS_ORDER_UNSPECIFIED,

LIST_SANDBOX_LOGS_ORDER_ASC,

LIST_SANDBOX_LOGS_ORDER_DESC

Response

entries

object[]

read-only

Show child attributes

nextPageToken

string

read-only

Token for the next page; empty on the last page.

retentionExpiresAt

string<date-time>

read-only

When the stored logs stop being readable. Absent while the sandbox has not ended.

Sandboxes

Use sandboxes

Manage sandboxes

Reference

Get v1sandboxes logs

Authorizations

Path Parameters

Query Parameters

Response