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

# Park an application deployment

> Park one deployment of this application: scale its workload to zero replicas on purpose, remembering the prior replica count as parked_replicas inside the stored deploy parameters. The write is the rollback's partial-update shape - one jsonb update of the stored inputs plus the platform's existing deploy job - and the push-to-deploy watermark is moved onto the newest observed build first so a build observed before the park is not converged onto the resting workload. The installation, its manifests and its published Ingress host all stay: parked is a deliberate rest, never not_deployed. Held to the applications.deploy permission. Browser session authentication with the X-Ankra-CSRF double-submit header only (no bearer twin).



## OpenAPI

````yaml https://platform.ankra.app/openapi.json post /org/applications/{application_id}/deployments/park
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
paths:
  /org/applications/{application_id}/deployments/park:
    post:
      tags:
        - Applications API
      summary: Park an application deployment
      description: >-
        Park one deployment of this application: scale its workload to zero
        replicas on purpose, remembering the prior replica count as
        parked_replicas inside the stored deploy parameters. The write is the
        rollback's partial-update shape - one jsonb update of the stored inputs
        plus the platform's existing deploy job - and the push-to-deploy
        watermark is moved onto the newest observed build first so a build
        observed before the park is not converged onto the resting workload. The
        installation, its manifests and its published Ingress host all stay:
        parked is a deliberate rest, never not_deployed. Held to the
        applications.deploy permission. Browser session authentication with the
        X-Ankra-CSRF double-submit header only (no bearer twin).
      operationId: park_application_deployment
      parameters:
        - in: path
          name: application_id
          required: true
          schema:
            title: Application Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParkDeploymentRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParkDeploymentResponse'
          description: Successful Response
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoDetailError'
          description: >-
            You do not have permission to park or wake deployments of this
            application.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoDetailError'
          description: >-
            Not found ("Application not found" or "Target cluster not found in
            this organisation.")
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoDetailError'
          description: The deployment is already parked / not parked, or is being removed
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ParkDeploymentRequest:
      description: >-
        Name the deployment to park or wake: the cluster it runs on and the
        namespace it runs in - the installation's identity beside the
        application the URL carries.
      properties:
        cluster_id:
          title: Cluster Id
          type: string
        namespace:
          title: Namespace
          type: string
      required:
        - cluster_id
        - namespace
      title: ParkDeploymentRequest
      type: object
    ParkDeploymentResponse:
      description: >-
        The deployment's rest state after a park or a wake: whether it is
        parked, the replica count it is converging to, and the remembered count
        a wake restores (null after a wake).
      properties:
        cluster_id:
          title: Cluster Id
          type: string
        namespace:
          title: Namespace
          type: string
        parked:
          title: Parked
          type: boolean
        replicas:
          title: Replicas
          type: string
        parked_replicas:
          anyOf:
            - type: string
            - type: 'null'
          title: Parked Replicas
      required:
        - cluster_id
        - namespace
        - parked
        - replicas
        - parked_replicas
      title: ParkDeploymentResponse
      type: object
    DemoDetailError:
      description: >-
        The FastAPI-style detail envelope the demo routes use for
        400/403/404/409/502 responses.
      properties:
        detail:
          type: string
      required:
        - detail
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````