> ## Documentation Index
> Fetch the complete documentation index at: https://oma-codex-339-workspace-permissions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Session Resources

> List Session Resources through the OMA API.

<Info>Every request requires `?beta=true`.</Info>


## OpenAPI

````yaml /openapi/oma.en.json get /v1/sessions/{session_id}/resources
openapi: 3.1.0
info:
  title: OMA API Reference
  version: 1.0.0
  description: Open Managed Agents application API reference.
servers:
  - url: http://localhost:38080
    description: Local OMA server
security:
  - omaApiKey: []
  - omaBearer: []
paths:
  /v1/sessions/{session_id}/resources:
    get:
      summary: List Session Resources
      operationId: BetaListResources
      parameters:
        - name: beta
          in: query
          required: true
          description: Selects the beta API contract for this endpoint. Must be `true`.
          schema:
            type: boolean
            enum:
              - true
        - name: anthropic-version
          in: header
          required: false
          schema:
            type: string
        - name: anthropic-beta
          in: header
          required: false
          schema:
            type: string
            items:
              type: string
            x-stainless-override-schema:
              x-stainless-param: betas
              x-stainless-extend-default: true
              type: array
              description: Optional header to specify the beta version(s) you want to use.
              items:
                $ref: '#/components/schemas/AnthropicBeta'
            x-default: managed-agents-2026-04-01
        - name: session_id
          in: path
          required: true
          schema:
            type: string
          description: Path parameter session_id
          example: sesn_011CZkZAtmR3yMPDzynEDxu7
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int32
          description: >-
            Maximum number of resources to return per page (max 1000). If
            omitted, returns all resources.
        - name: page
          in: query
          required: false
          schema:
            type: string
          description: Opaque cursor from a previous response's next_page field.
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsListSessionResources'
        '400':
          description: Invalid argument - The client specified an invalid argument
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '401':
          description: >-
            Unauthenticated - The request does not have valid authentication
            credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '403':
          description: >-
            Permission denied - The caller does not have permission to execute
            the specified operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '404':
          description: Not found - Some requested entity was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '408':
          description: >-
            Deadline exceeded - The deadline expired before the operation could
            complete
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '409':
          description: Aborted - The operation was aborted due to concurrency issue
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '412':
          description: >-
            Failed precondition - Operation was rejected because the system is
            not in required state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '413':
          description: Out of range - Operation was attempted past the valid range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '429':
          description: >-
            Resource exhausted - Some resource has been exhausted (rate
            limiting)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '431':
          description: Request header fields too large - Request metadata was too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '499':
          description: Cancelled - The operation was cancelled by the client
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '500':
          description: Internal - Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '501':
          description: Unimplemented - The operation is not implemented or supported
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '503':
          description: Unavailable - The service is currently unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '504':
          description: Deadline exceeded - Upstream service did not respond in time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
components:
  schemas:
    BetaManagedAgentsListSessionResources:
      description: Paginated list of resources attached to a session.
      type: object
      additionalProperties: false
      required:
        - data
      properties:
        data:
          description: Resources for the session, ordered by `created_at`.
          x-stainless-pagination-property:
            purpose: items
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionResource'
          examples:
            - - type: file
                id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
                file_id: file_011CNha8iCJcU1wXNR6q4V8w
                mount_path: /uploads/receipt.pdf
                created_at: '2026-03-15T10:00:00Z'
                updated_at: '2026-03-15T10:00:00Z'
              - type: github_repository
                id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
                url: https://github.com/example-org/example-repo
                mount_path: /workspace/example-repo
                checkout:
                  type: branch
                  name: main
                created_at: '2026-03-15T10:00:00Z'
                updated_at: '2026-03-15T10:00:00Z'
        next_page:
          description: Opaque cursor for the next page. Null when no more results.
          x-stainless-pagination-property:
            purpose: next_cursor_field
          type: string
          nullable: true
          examples:
            - page_MjAyNS0wNS0xNFQwMDowMDowMFo=
      example:
        data:
          - type: file
            id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
            file_id: file_011CNha8iCJcU1wXNR6q4V8w
            mount_path: /uploads/receipt.pdf
            created_at: '2026-03-15T10:00:00Z'
            updated_at: '2026-03-15T10:00:00Z'
          - type: github_repository
            id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
            url: https://github.com/example-org/example-repo
            mount_path: /workspace/example-repo
            checkout:
              type: branch
              name: main
            created_at: '2026-03-15T10:00:00Z'
            updated_at: '2026-03-15T10:00:00Z'
        next_page: page_MjAyNS0wNS0xNFQwMDowMDowMFo=
    BetaErrorResponse:
      properties:
        error:
          discriminator:
            mapping:
              api_error:
                $ref: '#/components/schemas/BetaAPIError'
              authentication_error:
                $ref: '#/components/schemas/BetaAuthenticationError'
              billing_error:
                $ref: '#/components/schemas/BetaBillingError'
              invalid_request_error:
                $ref: '#/components/schemas/BetaInvalidRequestError'
              not_found_error:
                $ref: '#/components/schemas/BetaNotFoundError'
              overloaded_error:
                $ref: '#/components/schemas/BetaOverloadedError'
              permission_error:
                $ref: '#/components/schemas/BetaPermissionError'
              rate_limit_error:
                $ref: '#/components/schemas/BetaRateLimitError'
              timeout_error:
                $ref: '#/components/schemas/BetaGatewayTimeoutError'
            propertyName: type
          oneOf:
            - $ref: '#/components/schemas/BetaInvalidRequestError'
            - $ref: '#/components/schemas/BetaAuthenticationError'
            - $ref: '#/components/schemas/BetaBillingError'
            - $ref: '#/components/schemas/BetaPermissionError'
            - $ref: '#/components/schemas/BetaNotFoundError'
            - $ref: '#/components/schemas/BetaRateLimitError'
            - $ref: '#/components/schemas/BetaGatewayTimeoutError'
            - $ref: '#/components/schemas/BetaAPIError'
            - $ref: '#/components/schemas/BetaOverloadedError'
          title: Error
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        type:
          const: error
          default: error
          title: Type
          type: string
      required:
        - error
        - request_id
        - type
      title: ErrorResponse
      type: object
    BetaManagedAgentsSessionResource:
      type: object
      discriminator:
        propertyName: type
        mapping:
          github_repository:
            $ref: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResource'
          file:
            $ref: '#/components/schemas/BetaManagedAgentsFileResource'
          memory_store:
            $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResource'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResource'
        - $ref: '#/components/schemas/BetaManagedAgentsFileResource'
        - $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResource'
    BetaAPIError:
      properties:
        message:
          default: Internal server error
          title: Message
          type: string
        type:
          const: api_error
          default: api_error
          title: Type
          type: string
      required:
        - message
        - type
      title: APIError
      type: object
    BetaAuthenticationError:
      properties:
        message:
          default: Authentication error
          title: Message
          type: string
        type:
          const: authentication_error
          default: authentication_error
          title: Type
          type: string
      required:
        - message
        - type
      title: AuthenticationError
      type: object
    BetaBillingError:
      properties:
        message:
          default: Billing error
          title: Message
          type: string
        type:
          const: billing_error
          default: billing_error
          title: Type
          type: string
      required:
        - message
        - type
      title: BillingError
      type: object
    BetaInvalidRequestError:
      properties:
        message:
          default: Invalid request
          title: Message
          type: string
        type:
          const: invalid_request_error
          default: invalid_request_error
          title: Type
          type: string
      required:
        - message
        - type
      title: InvalidRequestError
      type: object
    BetaNotFoundError:
      properties:
        message:
          default: Not found
          title: Message
          type: string
        type:
          const: not_found_error
          default: not_found_error
          title: Type
          type: string
      required:
        - message
        - type
      title: NotFoundError
      type: object
    BetaOverloadedError:
      properties:
        message:
          default: Overloaded
          title: Message
          type: string
        type:
          const: overloaded_error
          default: overloaded_error
          title: Type
          type: string
      required:
        - message
        - type
      title: OverloadedError
      type: object
    BetaPermissionError:
      properties:
        message:
          default: Permission denied
          title: Message
          type: string
        type:
          const: permission_error
          default: permission_error
          title: Type
          type: string
      required:
        - message
        - type
      title: PermissionError
      type: object
    BetaRateLimitError:
      properties:
        message:
          default: Rate limited
          title: Message
          type: string
        type:
          const: rate_limit_error
          default: rate_limit_error
          title: Type
          type: string
      required:
        - message
        - type
      title: RateLimitError
      type: object
    BetaGatewayTimeoutError:
      properties:
        message:
          default: Request timeout
          title: Message
          type: string
        type:
          const: timeout_error
          default: timeout_error
          title: Type
          type: string
      required:
        - message
        - type
      title: GatewayTimeoutError
      type: object
    BetaManagedAgentsGitHubRepositoryResource:
      type: object
      additionalProperties: false
      required:
        - type
        - id
        - url
        - mount_path
        - created_at
        - updated_at
      properties:
        type:
          type: string
          enum:
            - github_repository
          examples:
            - github_repository
        id:
          type: string
          examples:
            - sesrsc_011CZkZCKr6eXyl0gWMOdQiu
        url:
          type: string
          examples:
            - https://github.com/example-org/example-repo
        mount_path:
          type: string
          examples:
            - /workspace/example-repo
        checkout:
          $ref: '#/components/schemas/BetaManagedAgentsRepositoryCheckout'
          nullable: true
          examples:
            - type: branch
              name: main
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
      example:
        type: github_repository
        id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
        url: https://github.com/example-org/example-repo
        mount_path: /workspace/example-repo
        checkout:
          type: branch
          name: main
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
    BetaManagedAgentsFileResource:
      type: object
      additionalProperties: false
      required:
        - type
        - id
        - file_id
        - mount_path
        - created_at
        - updated_at
      properties:
        type:
          type: string
          enum:
            - file
          examples:
            - file
        id:
          type: string
          examples:
            - sesrsc_011CZkZBJq5dWxk9fVLNcPht
        file_id:
          type: string
          examples:
            - file_011CNha8iCJcU1wXNR6q4V8w
        mount_path:
          type: string
          examples:
            - /uploads/receipt.pdf
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
      example:
        type: file
        id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
        file_id: file_011CNha8iCJcU1wXNR6q4V8w
        mount_path: /uploads/receipt.pdf
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
    BetaManagedAgentsMemoryStoreResource:
      description: A memory store attached to an agent session.
      type: object
      additionalProperties: false
      required:
        - type
        - memory_store_id
      properties:
        type:
          type: string
          enum:
            - memory_store
        memory_store_id:
          description: >-
            The memory store ID (memstore_...). Must belong to the caller's
            organization and workspace.
          type: string
        access:
          description: >-
            Access mode for the mounted store. Defaults to read_write. read_only
            mounts the store as a read-only filesystem.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsMountMode'
          nullable: true
        name:
          description: >-
            Display name of the memory store, snapshotted at attach time. Later
            edits to the store's name do not propagate to this resource.
          type: string
          nullable: true
        description:
          description: >-
            Description of the memory store, snapshotted at attach time.
            Rendered into the agent's system prompt. Empty string when the store
            has no description.
          type: string
        instructions:
          description: >-
            Per-attachment guidance for the agent on how to use this store.
            Rendered into the memory section of the system prompt. Max 4096
            chars.
          type: string
          maxLength: 4096
          nullable: true
        mount_path:
          description: >-
            Filesystem path where the store is mounted in the session container,
            e.g. /mnt/memory/user-preferences. Derived from the store's name.
            Output-only.
          type: string
          nullable: true
    BetaManagedAgentsRepositoryCheckout:
      type: object
      discriminator:
        propertyName: type
        mapping:
          branch:
            $ref: '#/components/schemas/BetaManagedAgentsBranchCheckout'
          commit:
            $ref: '#/components/schemas/BetaManagedAgentsCommitCheckout'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsBranchCheckout'
        - $ref: '#/components/schemas/BetaManagedAgentsCommitCheckout'
    BetaTimestamp:
      description: A timestamp in RFC 3339 format
      type: string
      format: date-time
    BetaManagedAgentsMountMode:
      type: string
      description: Access mode for an attached memory store.
      enum:
        - read_write
        - read_only
    BetaManagedAgentsBranchCheckout:
      type: object
      additionalProperties: false
      required:
        - type
        - name
      properties:
        type:
          type: string
          enum:
            - branch
          examples:
            - branch
        name:
          description: Branch name to check out.
          type: string
          minLength: 1
          maxLength: 255
          examples:
            - main
      example:
        type: branch
        name: main
    BetaManagedAgentsCommitCheckout:
      type: object
      additionalProperties: false
      required:
        - type
        - sha
      properties:
        type:
          type: string
          enum:
            - commit
        sha:
          description: Full commit SHA to check out.
          type: string
          minLength: 7
          maxLength: 64
  securitySchemes:
    omaApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: OMA workspace API key.
      x-default: sk-ant-local-default
    omaBearer:
      type: http
      scheme: bearer
      description: OMA workspace API key sent as a bearer token.

````