> ## 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. # Submit input to an agent conversation > Submit native Pi input to an existing conversation belonging to the authenticated user. Returns the native submission record after durable admission; execution continues after disconnection. An optional requestId deduplicates input within this conversation. ## OpenAPI ````yaml https://platform.usecontextlayer.com/api/openapi.json post /slates/{target}/agents/{name}/{actor}/conversations/{conversationId}/submissions 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}/conversations/{conversationId}/submissions: post: tags: - Agent conversations summary: Submit input to an agent conversation description: >- Submit native Pi input to an existing conversation belonging to the authenticated user. Returns the native submission record after durable admission; execution continues after disconnection. An optional requestId deduplicates input within this conversation. operationId: submitAgentInput 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 description: >- Manual input is supported only in the authenticated caller's SlateAgent. required: true description: >- Manual input is supported only in the authenticated caller's SlateAgent. name: actor in: path - schema: type: integer exclusiveMinimum: 0 required: true name: conversationId in: path requestBody: required: true content: application/json: schema: type: object properties: content: anyOf: - type: string - type: array items: oneOf: - type: object properties: text: type: string textSignature: type: string type: type: string enum: - text required: - text - type - type: object properties: data: type: string mimeType: type: string type: type: string enum: - image required: - data - mimeType - type requestId: type: string description: Native Pi deduplication key, scoped to this conversation. required: - content additionalProperties: false responses: '202': description: Native Pi submission with its durable ID and current status 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, actor, conversation ID, or input '401': description: A valid ContextLayer login is required '403': description: Slate viewing is forbidden or the slate is public '404': description: Slate, agent definition, or conversation not found '409': description: A required connection assignment or personal secret is missing content: application/json: schema: anyOf: - type: object properties: reason: type: string enum: - connection-required slug: type: string minLength: 1 required: - reason - slug - type: object properties: name: type: string minLength: 1 reason: type: string enum: - secret-required required: - name - reason 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.