> ## 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.

# List coding sessions on an imported app

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

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 and created_by_user_id. 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 on an imported app
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        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 and created_by_user_id. 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:
            type: string
            maxLength: 2048
            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:
            type: string
            minLength: 1
            maxLength: 200
            pattern: ^[A-Za-z0-9_.:-]+$
            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.
        - name: created_by_user_id
          in: query
          required: false
          schema:
            type: string
            pattern: ^(me|[a-f0-9]{24})$
            description: >-
              Restrict the page to sessions launched by this user ID, or `me`
              for your own. Omit it to list every user's sessions. Keep this
              filter unchanged when you pass next_cursor as cursor.
            examples:
              - me
            title: Created By User Id
          description: >-
            Restrict the page to sessions launched by this user ID, or `me` for
            your own. Omit it to list every user's sessions. Keep this filter
            unchanged when you pass next_cursor as cursor.
      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, limit, or creator filter.
          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.
            `source_ref_not_found`: `source_ref` isn't a branch in the connected
            repository.
          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'
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
        - WorkspaceApiKeyAuth:
            - full_access
        - WorkspaceApiKeyBearerAuth:
            - 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
        created_by_user_id:
          type: string
          title: Created By User Id
          description: >-
            The ID of the user who launched the session. A session launched with
            a workspace API key reports the key's owner.
          examples:
            - 6820f3a4e7b91d003c45a1f4
        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. To answer, use the `input_request_id`
            from Get a coding session's open question.
          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:
            - base-code/fix-login-redirect-45a1f2
        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 pull request of the branch the session launched on, in the
            connected repository, or `null` until one is opened. `pull_requests`
            lists every pull request of the session.
          examples:
            - number: 123
              url: https://github.com/acme/project/pull/123
        pull_requests:
          items:
            $ref: '#/components/schemas/SessionPullRequestListItem'
          type: array
          title: Pull Requests
          description: >-
            Every pull request of the session, for each branch in `branches` and
            each repository: the connected repository and the repositories added
            to a multi-repository project. Ordered by branch as in `branches`;
            within a branch, the connected repository first, then the added
            repositories. Empty until a pull request is opened.
          examples:
            - - branch_id: 6820f3a4e7b91d003c45a1f3
                branch_name: base-code/fix-login-redirect-45a1f2
                is_draft: false
                number: 123
                repository_full_name: acme/project
                state: open
                url: https://github.com/acme/project/pull/123
              - branch_id: 6820f3a4e7b91d003c45a1f3
                branch_name: base-code/fix-login-redirect-45a1f2
                is_draft: false
                number: 45
                repository_full_name: acme/api
                state: merged
                url: https://github.com/acme/api/pull/45
        branches:
          items:
            $ref: '#/components/schemas/SessionBranch'
          type: array
          title: Branches
          description: >-
            The session's branches: the branch it launched on first, then the
            branches opened in the same Base Code session (for example after
            continuing it in the editor), in the order they were added. Merged
            and deleted branches stay listed. Empty before provisioning.
          examples:
            - - branch_id: 6820f3a4e7b91d003c45a1f3
                branch_name: base-code/fix-login-redirect-45a1f2
                is_current: false
              - branch_id: 6820f3a4e7b91d003c45a1f5
                branch_name: fix-login-copy
                is_current: true
        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
        error_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Reason
          description: >-
            A short, human-readable explanation of `error_code` and what to do
            next, or `null` if there is no failure or cut-short turn.
          examples:
            - >-
              The branch's sandbox ran out of disk space. Crash dumps were
              removed; send the message again.
        outcome:
          anyOf:
            - type: string
              enum:
                - pull_request
                - answer
            - type: 'null'
          title: Outcome
          description: >-
            How a `completed` session ended: `pull_request` when it opened or
            updated a pull request, `answer` when it ended without one and
            replied instead; `has_unpublished_changes` says whether that branch
            still changes files. `null` until the session completes. Pull
            requests opened later on the session's other branches don't change
            it; read `pull_requests` for those.
          examples:
            - pull_request
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
          description: >-
            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.
          examples:
            - Removed the retired flag and kept the enabled behavior.
        live_turns:
          items:
            $ref: '#/components/schemas/SessionLiveTurn'
          type: array
          title: Live Turns
          description: >-
            Turns running on the session's branches (every branch in `branches`)
            after it finished: a PR Watch turn fixing review findings, or a turn
            someone started in the editor. Empty when nothing is running.
            `state` keeps its finished value, so poll this field to tell a
            finished, idle session from one still working.
          examples:
            - - branch_id: 6820f3a4e7b91d003c45a1f3
        latest_watch_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Latest Watch Summary
          description: >-
            The final reply of the most recent PR Watch turn on the session's
            branch, in Markdown up to 10,000 characters, or `null` when no Watch
            turn has replied. A Watch turn that changed nothing leaves `summary`
            as it was, so its conclusion appears only here.
          examples:
            - >-
              Re-ran the flaky check: infrastructure timeout, no code change
              needed.
        has_unpublished_changes:
          type: boolean
          title: Has Unpublished Changes
          description: >-
            `true` when an `answer` session's branch changes files that no pull
            request carries yet: send a message asking for one to have the agent
            open it. `false` otherwise.
          default: false
          examples:
            - false
        push_failed:
          type: boolean
          title: Push Failed
          description: >-
            `true` when a `pull_request` session's last changes did not reach
            the pull request's branch on GitHub because the push failed;
            `summary` then starts with a warning that says where the work is.
            `false` otherwise.
          default: false
          examples:
            - false
      type: object
      required:
        - id
        - created_by_user_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
    SessionPullRequestListItem:
      properties:
        repository_full_name:
          type: string
          title: Repository Full Name
          description: >-
            The repository the pull request is in: the connected repository, or
            a repository added to a multi-repository project.
          examples:
            - acme/project
        number:
          type: integer
          title: Number
          description: The pull request's number in its repository.
          examples:
            - 123
        url:
          type: string
          title: Url
          description: The pull request's URL.
          examples:
            - https://github.com/acme/project/pull/123
        branch_id:
          type: string
          title: Branch Id
          description: The session branch whose Git branch is the pull request's head.
          examples:
            - 6820f3a4e7b91d003c45a1f3
        branch_name:
          type: string
          title: Branch Name
          description: The pull request's head Git branch.
          examples:
            - base-code/fix-login-redirect-45a1f2
        state:
          anyOf:
            - type: string
              enum:
                - open
                - merged
                - closed
            - type: 'null'
          title: State
          description: >-
            `open`, `merged`, or `closed` (closed without a merge), or `null`
            when GitHub could not be read. A merged branch's pull request in the
            connected repository is `merged`.
          examples:
            - open
        is_draft:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Draft
          description: >-
            Whether the pull request is a draft, or `null` when `state` is
            `null`.
          examples:
            - false
      type: object
      required:
        - repository_full_name
        - number
        - url
        - branch_id
        - branch_name
        - state
        - is_draft
      title: SessionPullRequestListItem
    SessionBranch:
      properties:
        branch_id:
          type: string
          title: Branch Id
          description: The Base Code branch identifier.
          examples:
            - 6820f3a4e7b91d003c45a1f3
        branch_name:
          type: string
          title: Branch Name
          description: The branch's Git branch.
          examples:
            - base-code/fix-login-redirect-45a1f2
        is_current:
          type: boolean
          title: Is Current
          description: Whether this is the branch the session's conversation works on now.
          examples:
            - true
      type: object
      required:
        - branch_id
        - branch_name
        - is_current
      title: SessionBranch
    SessionLiveTurn:
      properties:
        branch_id:
          type: string
          title: Branch Id
          description: The session branch the running turn works on.
          examples:
            - 6820f3a4e7b91d003c45a1f3
      type: object
      required:
        - branch_id
      title: SessionLiveTurn
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        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`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.