Get coding session

Get coding session

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}"

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

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

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}', 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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}",
  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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}"

	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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}")

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

{
  "id": "6820f3a4e7b91d003c45a1f2",
  "state": "running",
  "message_id": "ca00e880-1111-4444-aaaa-ccddeeff0011",
  "repository_full_name": "acme/project",
  "branch_id": "6820f3a4e7b91d003c45a1f3",
  "branch_name": "codex/session-6820f3a4e7b91d003c45a1f2",
  "session_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/editor/preview",
  "pull_request": {
    "number": 123,
    "url": "https://github.com/acme/project/pull/123"
  },
  "error_code": "execution_failed",
  "launch_key": "flag-cleanup-123",
  "client_reference": "release-task-123",
  "input_request_id": "ca00e880-1111-4444-aaaa-ccddeeff0011",
  "outcome": "pull_request",
  "summary": "Removed the retired flag and kept the enabled behavior."
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

GET

api

apps

{app_id}

imported

sessions

{session_id}

Get coding session

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}"

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

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

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}', 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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}",
  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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}"

	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://app.base44.com/api/apps/{app_id}/imported/sessions/{session_id}")

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

{
  "id": "6820f3a4e7b91d003c45a1f2",
  "state": "running",
  "message_id": "ca00e880-1111-4444-aaaa-ccddeeff0011",
  "repository_full_name": "acme/project",
  "branch_id": "6820f3a4e7b91d003c45a1f3",
  "branch_name": "codex/session-6820f3a4e7b91d003c45a1f2",
  "session_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/editor/preview",
  "pull_request": {
    "number": 123,
    "url": "https://github.com/acme/project/pull/123"
  },
  "error_code": "execution_failed",
  "launch_key": "flag-cleanup-123",
  "client_reference": "release-task-123",
  "input_request_id": "ca00e880-1111-4444-aaaa-ccddeeff0011",
  "outcome": "pull_request",
  "summary": "Removed the retired flag and kept the enabled behavior."
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

session_id

string

required

The session's identifier.

Pattern: ^[a-f0-9]{24}$

Example:

"6820f3a4e7b91d003c45a1f2"

app_id

string

required

Response

Successful Response

string

required

The session's opaque identifier.

Example:

"6820f3a4e7b91d003c45a1f2"

state

enum<string>

required

The session's state: queued, running, opening_pull_request, needs_input, completed, failed, cancelling, or cancelled.

Available options:

queued,

running,

opening_pull_request,

needs_input,

completed,

failed,

cancelling,

cancelled

Example:

"running"

message_id

string | null

required

The UUID of the session's user message, or null before dispatch. Queued processing updates it to the UUID used for the turn.

Example:

"ca00e880-1111-4444-aaaa-ccddeeff0011"

repository_full_name

string

required

The connected repository the session runs in.

Example:

"acme/project"

branch_id

string | null

required

The session's Base Code branch identifier, or null before provisioning.

Example:

"6820f3a4e7b91d003c45a1f3"

branch_name

string | null

required

The session's working Git branch, or null before provisioning.

Example:

"codex/session-6820f3a4e7b91d003c45a1f2"

session_url

string | null

required

The Base Code editor URL for inspecting the session or answering pending questions, or null until its branch is provisioned.

Example:

"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/editor/preview"

pull_request

SessionPullRequest · object | null

required

The session's pull request, or null until one is opened.

Show child attributes

Example:

{
  "number": 123,
  "url": "https://github.com/acme/project/pull/123"
}

error_code

string | null

required

The stable failure cause, or null if there is no failure.

Example:

"execution_failed"

launch_key

string | null

The original Idempotency-Key, or null for sessions created before key recovery was recorded. Use the same principal and key to retry a queued launch.

Example:

"flag-cleanup-123"

client_reference

string | null

Your application reconciliation reference, or null.

Example:

"release-task-123"

input_request_id

string | null

Opaque identifier of the current question or approval pause, or null when the session is not waiting for input or the pause predates identifier tracking. Use it to deduplicate notifications for repeated input requests. To answer, use the input_request_id from Get a coding session's open question.

Example:

"ca00e880-1111-4444-aaaa-ccddeeff0011"

outcome

enum<string> | null

How a completed session ended: pull_request when it opened or updated a pull request, answer when the request needed no code change and the session replied instead. null until the session completes.

Available options:

pull_request,

answer

Example:

"pull_request"

summary

string | null

The session's final reply in Markdown, up to 10,000 characters: the answer for an answer outcome, the change summary for a pull_request outcome. null until the session publishes.

Example:

"Removed the retired flag and kept the enabled behavior."

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Authorizations

Path Parameters

Response