> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.
# List coding sessions
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
List this imported app's sessions, newest first by creation time and identifier. Authenticate with platform Bearer credentials and app editor access. Defaults to 20 items; maximum 100. Return next_cursor as cursor with the same limit. Shares the 60 reads per minute per user limit. Every response includes request and rate-limit headers.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/imported/sessions
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/imported/sessions:
get:
summary: List coding sessions
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
List this imported app's sessions, newest first by creation time and
identifier. Authenticate with platform Bearer credentials and app editor
access. Defaults to 20 items; maximum 100. Return next_cursor as cursor
with the same limit. Shares the 60 reads per minute per user limit.
Every response includes request and rate-limit headers.
operationId: get_sessions_api_apps__app_id__imported_sessions_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
title: App Id
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Maximum sessions per page. Defaults to 20.
examples:
- 20
default: 20
title: Limit
description: Maximum sessions per page. Defaults to 20.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 2048
- type: 'null'
description: >-
The next_cursor from the previous page, or omit it for the first
page.
examples:
- gAAAAABn7vJ...
title: Cursor
description: >-
The next_cursor from the previous page, or omit it for the first
page.
- name: client_reference
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 200
minLength: 1
pattern: ^[A-Za-z0-9_.:-]+$
- type: 'null'
description: >-
Restrict the page to your application reference, or omit it to
list all sessions.
examples:
- release-task-123
title: Client Reference
description: >-
Restrict the page to your application reference, or omit it to list
all sessions.
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SessionList'
'400':
description: >-
`invalid_cursor`: The cursor is invalid or belongs to another app,
workspace, or limit.
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'401':
description: '`unauthenticated`: Missing or invalid credentials.'
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'403':
description: '`forbidden`: You don''t have write access to this app or repository.'
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'404':
description: '`not_found`: The imported app or session was not found.'
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'409':
description: >-
`idempotency_conflict` or `conflict`: The request conflicts with an
earlier launch or current repository state.
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'422':
description: '`invalid_request`: The input or Idempotency-Key is invalid.'
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'429':
description: '`rate_limited`: Retry after the number of seconds in Retry-After.'
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
'500':
description: >-
`internal_error`: Unexpected failure. Retry a launch with the same
Idempotency-Key.
content:
application/json:
schema:
$ref: '#/components/schemas/StandardErrorEnvelope'
security:
- PersonalAccessTokenAuth:
- full_access
components:
schemas:
SessionList:
properties:
items:
items:
$ref: '#/components/schemas/SessionResponse'
type: array
title: Items
description: >-
Sessions ordered by creation time, newest first, then identifier
descending.
examples:
- []
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
description: An opaque token for the next page, or `null` for the last page.
examples:
- null
type: object
required:
- items
- next_cursor
title: SessionList
StandardErrorEnvelope:
properties:
error:
$ref: '#/components/schemas/StandardError'
description: What went wrong.
type: object
required:
- error
title: StandardErrorEnvelope
description: The error body returned in the standard envelope.
SessionResponse:
properties:
launch_key:
anyOf:
- type: string
- type: 'null'
title: Launch Key
description: >-
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.
examples:
- flag-cleanup-123
client_reference:
anyOf:
- type: string
- type: 'null'
title: Client Reference
description: Your application reconciliation reference, or null.
examples:
- release-task-123
id:
type: string
title: Id
description: The session's opaque identifier.
examples:
- 6820f3a4e7b91d003c45a1f2
state:
type: string
enum:
- queued
- running
- opening_pull_request
- needs_input
- completed
- failed
- cancelling
- cancelled
title: State
description: >-
The session's state: `queued`, `running`, `opening_pull_request`,
`needs_input`, `completed`, `failed`, `cancelling`, or `cancelled`.
examples:
- running
message_id:
anyOf:
- type: string
- type: 'null'
title: Message Id
description: >-
The UUID of the session's user message, or `null` before dispatch.
Queued processing updates it to the UUID used for the turn.
examples:
- ca00e880-1111-4444-aaaa-ccddeeff0011
input_request_id:
anyOf:
- type: string
- type: 'null'
title: Input Request Id
description: >-
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.
examples:
- ca00e880-1111-4444-aaaa-ccddeeff0011
repository_full_name:
type: string
title: Repository Full Name
description: The connected repository the session runs in.
examples:
- acme/project
branch_id:
anyOf:
- type: string
- type: 'null'
title: Branch Id
description: >-
The session's Base Code branch identifier, or `null` before
provisioning.
examples:
- 6820f3a4e7b91d003c45a1f3
branch_name:
anyOf:
- type: string
- type: 'null'
title: Branch Name
description: The session's working Git branch, or `null` before provisioning.
examples:
- codex/session-6820f3a4e7b91d003c45a1f2
session_url:
anyOf:
- type: string
- type: 'null'
title: Session Url
description: >-
The Base Code editor URL for inspecting the session or answering
pending questions, or `null` until its branch is provisioned.
examples:
- >-
https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/editor/preview
pull_request:
anyOf:
- $ref: '#/components/schemas/SessionPullRequest'
- type: 'null'
description: The session's pull request, or `null` until one is opened.
examples:
- number: 123
url: https://github.com/acme/project/pull/123
error_code:
anyOf:
- type: string
- type: 'null'
title: Error Code
description: The stable failure cause, or `null` if there is no failure.
examples:
- execution_failed
type: object
required:
- id
- state
- message_id
- repository_full_name
- branch_id
- branch_name
- session_url
- pull_request
- error_code
title: SessionResponse
StandardError:
properties:
code:
type: string
title: Code
description: >-
Stable machine-readable cause of the failure. Match on this, not on
`message`.
example: not_found
message:
type: string
title: Message
description: Human-readable explanation. It isn't a stable contract.
example: App not found
details:
additionalProperties: true
type: object
title: Details
description: >-
Structured context for the failure, or an empty object when there's
none.
example: {}
type: object
required:
- code
- message
title: StandardError
SessionPullRequest:
properties:
number:
type: integer
title: Number
description: The pull request's number in the connected repository.
examples:
- 123
url:
type: string
title: Url
description: The pull request's URL.
examples:
- https://github.com/acme/project/pull/123
type: object
required:
- number
- url
title: SessionPullRequest
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: >-
Personal access token, sent as `Authorization: Bearer `. 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`.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.