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

# Delete a session

> Delete the session for the application and user; success returns JSON null

<Warning>
  This operation deletes the session and its history for the specified application and user. This endpoint provides no restore operation. Preserve any state and events you need, and confirm the session identifier first
</Warning>

Success returns HTTP `200` with JSON `null`, rather than `204`. Deleting a session does not undo external actions already completed by tools


## OpenAPI

````yaml productions/api-reference/openapi/en/harness-runtime.json DELETE /apps/{app_name}/users/{user_id}/sessions/{session_id}
openapi: 3.1.0
info:
  title: Harness Runtime
  version: agentkit-cli 0.54.0 / SDK 0.8.0 / ADK 2.2.0
  description: >-
    Harness Runtime deployed by AgentKit CLI 0.54.0, verified with VeADK 1.0.8,
    AgentKit SDK 0.8.0, and Google ADK 2.2.0; scheduled tasks require separate
    enablement
servers:
  - url: http://localhost:8000
    description: Local server
security:
  - {}
  - RuntimeBearer: []
tags:
  - name: Service and applications
  - name: Sessions
  - name: Agent execution
  - name: Artifacts
  - name: Memory
  - name: Evaluation · development server
  - name: Debugging · development server
  - name: Compatibility endpoints
  - name: Harness cronjobs
paths:
  /apps/{app_name}/users/{user_id}/sessions/{session_id}:
    delete:
      tags:
        - Sessions
      summary: Delete a session
      description: >-
        Delete the session for the application and user; success returns JSON
        null
      operationId: harnessRuntimeDeleteSession
      parameters:
        - name: app_name
          in: path
          required: true
          schema:
            type: string
            title: App Name
          description: Application name; harness_agent for the CLI deployment
          example: harness_agent
        - name: user_id
          in: path
          required: true
          schema:
            type: string
            title: User Id
          description: User ID
          example: user-001
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            title: Session Id
          description: Session ID
          example: session-001
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: 'null'
              example: null
        '422':
          description: Request validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
          description: Error details
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
          description: Location of the invalid field
        msg:
          type: string
          title: Message
          description: Validation error message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    RuntimeBearer:
      type: http
      scheme: bearer
      description: >-
        Optional locally without a gateway; cloud deployments use the Runtime
        API key or user-pool JWT required by that deployment, never the model
        API key

````