> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontextlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an agent submission

> Read a native Pi submission in the selected user or app agent instance. A completed input's answer identifies its exact entry; retrieve it through listAgentEntries with equal minEntryId and maxEntryId and limit=1. This operation does not wait for completion.



## OpenAPI

````yaml https://platform.usecontextlayer.com/api/openapi.json get /slates/{target}/agents/{name}/{actor}/submissions/{submissionId}
openapi: 3.1.0
info:
  title: ContextLayer Platform
  version: 0.1.0
servers:
  - url: https://platform.usecontextlayer.com/api
security: []
tags:
  - name: Slates
  - name: Slate routing
  - name: Slate resources
  - name: Accounts
  - name: Shared secrets
  - name: Agents
  - name: Agent conversations
paths:
  /slates/{target}/agents/{name}/{actor}/submissions/{submissionId}:
    get:
      tags:
        - Agent conversations
      summary: Get an agent submission
      description: >-
        Read a native Pi submission in the selected user or app agent instance.
        A completed input's answer identifies its exact entry; retrieve it
        through listAgentEntries with equal minEntryId and maxEntryId and
        limit=1. This operation does not wait for completion.
      operationId: getAgentSubmission
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Agent directory name under agents/ in the pushed source.
          required: true
          description: Agent directory name under agents/ in the pushed source.
          name: name
          in: path
        - schema:
            anyOf:
              - type: string
                format: uuid
              - type: string
          required: true
          name: target
          in: path
        - schema:
            type: string
            enum:
              - user
              - app
            description: >-
              Required instance address: user selects the authenticated caller's
              SlateAgent; app selects this named agent's app SlateAgent. Native
              IDs and cursors belong to that instance.
          required: true
          description: >-
            Required instance address: user selects the authenticated caller's
            SlateAgent; app selects this named agent's app SlateAgent. Native
            IDs and cursors belong to that instance.
          name: actor
          in: path
        - schema:
            type: integer
            exclusiveMinimum: 0
          required: true
          name: submissionId
          in: path
      responses:
        '200':
          description: Native Pi submission and its current outcome
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - input
                      status:
                        type: string
                        enum:
                          - queued
                    required:
                      - conversationId
                      - id
                      - type
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - input
                      entry:
                        type: integer
                        exclusiveMinimum: 0
                      status:
                        type: string
                        enum:
                          - placed
                    required:
                      - conversationId
                      - id
                      - type
                      - entry
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - input
                      answer:
                        type: integer
                        exclusiveMinimum: 0
                      entry:
                        type: integer
                        exclusiveMinimum: 0
                      status:
                        type: string
                        enum:
                          - done
                    required:
                      - conversationId
                      - id
                      - type
                      - answer
                      - entry
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - input
                      detail:
                        type:
                          - string
                          - number
                          - boolean
                          - 'null'
                          - object
                          - array
                        additionalProperties: true
                        description: >-
                          Opaque native JSON detail for an unanswered
                          submission.
                        items: {}
                      reason:
                        type: string
                      status:
                        type: string
                        enum:
                          - unanswered
                      entry:
                        type: integer
                        exclusiveMinimum: 0
                    required:
                      - conversationId
                      - id
                      - type
                      - reason
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - write
                      status:
                        type: string
                        enum:
                          - queued
                    required:
                      - conversationId
                      - id
                      - type
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - write
                      entry:
                        type: integer
                        exclusiveMinimum: 0
                      status:
                        type: string
                        enum:
                          - done
                    required:
                      - conversationId
                      - id
                      - type
                      - entry
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - write
                      detail:
                        type:
                          - string
                          - number
                          - boolean
                          - 'null'
                          - object
                          - array
                        additionalProperties: true
                        description: >-
                          Opaque native JSON detail for an unanswered
                          submission.
                        items: {}
                      reason:
                        type: string
                      status:
                        type: string
                        enum:
                          - unanswered
                    required:
                      - conversationId
                      - id
                      - type
                      - reason
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - continue
                      status:
                        type: string
                        enum:
                          - placed
                    required:
                      - conversationId
                      - id
                      - type
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - continue
                      answer:
                        type: integer
                        exclusiveMinimum: 0
                      status:
                        type: string
                        enum:
                          - done
                    required:
                      - conversationId
                      - id
                      - type
                      - answer
                      - status
                    additionalProperties: {}
                  - type: object
                    properties:
                      conversationId:
                        type: integer
                        exclusiveMinimum: 0
                      id:
                        type: integer
                        exclusiveMinimum: 0
                      requestId:
                        type: string
                      trace:
                        type: object
                        additionalProperties:
                          type: string
                      type:
                        type: string
                        enum:
                          - continue
                      detail:
                        type:
                          - string
                          - number
                          - boolean
                          - 'null'
                          - object
                          - array
                        additionalProperties: true
                        description: >-
                          Opaque native JSON detail for an unanswered
                          submission.
                        items: {}
                      reason:
                        type: string
                      status:
                        type: string
                        enum:
                          - unanswered
                    required:
                      - conversationId
                      - id
                      - type
                      - reason
                      - status
                    additionalProperties: {}
        '400':
          description: Invalid slate target, agent name, submission ID, or actor
        '401':
          description: A valid ContextLayer login is required
        '403':
          description: Slate viewing is forbidden or the slate is public
        '404':
          description: Slate or submission not found
      security:
        - bearerAuth: []
        - webCookie: []
        - localWebCookie: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    webCookie:
      in: cookie
      name: __Secure-better-auth.session_token
      type: apiKey
    localWebCookie:
      in: cookie
      name: better-auth.session_token
      type: apiKey

````

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