Get Agent Run Logs

Retrieve an agent run with its logs using pagination. This endpoint is currently in ALPHA and IS subject to change.

Returns the agent run details along with a paginated list of logs for the specified agent run. The agent run must belong to the specified organization. Logs are returned in chronological order. Uses standard pagination parameters (skip and limit) and includes pagination metadata in the response.

Rate limit: 60 requests per 60 seconds.

GET /v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs

Get Agent Run Logs

cURL

curl --request GET \
  --url https://api.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs

import requests

url = "https://api.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/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.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs"

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

	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.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.codegen.com/v1/alpha/organizations/{org_id}/agent/run/{agent_run_id}/logs")

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

request = Net::HTTP::Get.new(url)

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

200

{
  "id": 123,
  "organization_id": 123,
  "logs": [
    {
      "agent_run_id": 123,
      "created_at": "<string>",
      "tool_name": "<string>",
      "message_type": "<string>",
      "thought": "<string>",
      "observation": {},
      "tool_input": {},
      "tool_output": {}
    }
  ],
  "status": "<string>",
  "created_at": "<string>",
  "web_url": "<string>",
  "result": "<string>",
  "metadata": {},
  "total_logs": 123,
  "page": 123,
  "size": 123,
  "pages": 123
}

{
  "message": "You do not have access to this organization.",
  "status_code": 403
}

{
  "message": "Agent run not found.",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

{
  "message": "Rate limit exceeded. Please try again later.",
  "status_code": 429
}

Headers

Path Parameters

agent_run_id · integer · required

org_id · integer · required

Query Parameters

skip · integer · default: 0

Required range: x >= 0

limit · integer · default: 100

Required range: 1 <= x <= 100

reverse · boolean · default: false

Response

200

application/json

Successful Response

Represents an agent run in API responses

id · integer · required

organization_id · integer · required

logs · AgentRunLogResponse · object[] · required

Show child attributes

status · string | null

created_at · string | null

web_url · string | null

result · string | null

metadata · Metadata · object | null

total_logs · integer | null

page · integer | null

size · integer | null

pages · integer | null