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

> ## Agent Instructions
> This is the Sevalla REST API reference. Base URL: https://api.sevalla.com/v3. Authenticate with an API key in the Authorization header as a Bearer token.
> The OpenAPI spec is at https://api.sevalla.com/v3/openapi.json. Concepts and dashboard guides are at https://docs.sevalla.com (index: https://docs.sevalla.com/llms.txt).
> To act on a Sevalla account from an AI agent, prefer the Sevalla MCP server (https://mcp.sevalla.com/mcp, see https://docs.sevalla.com/ai-agents/overview.md) or the Sevalla CLI (https://api-docs.sevalla.com/v3/cli.md).

# Attach or update process disk

> Attach a persistent disk to a web or worker process, or change the size or mount path of its disk. A disk can grow but cannot shrink. A disk can only be mounted by one instance, so if the process uses more than one instance or horizontal scaling, it is switched to manual scaling with one instance. The change takes effect on the next deployment, and the disk is billed while it exists.



## OpenAPI

````yaml https://api.sevalla.com/v3/openapi.json put /applications/{id}/processes/{process_id}/disk
openapi: 3.1.0
info:
  title: Sevalla API docs
  version: 1.0.0
servers:
  - url: https://api.sevalla.com/v3
security:
  - bearerAuth: []
paths:
  /applications/{id}/processes/{process_id}/disk:
    put:
      tags:
        - Applications
      summary: Attach or update process disk
      description: >-
        Attach a persistent disk to a web or worker process, or change the size
        or mount path of its disk. A disk can grow but cannot shrink. A disk can
        only be mounted by one instance, so if the process uses more than one
        instance or horizontal scaling, it is switched to manual scaling with
        one instance. The change takes effect on the next deployment, and the
        disk is billed while it exists.
      operationId: updateProcessDiskV3
      parameters:
        - schema:
            example: fb5e5168-4281-4bec-94c5-0d1584e9e657
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: id
          required: true
          description: Application identifier
        - schema:
            example: fb5e5168-4281-4bec-94c5-0d1584e9e657
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: process_id
          required: true
          description: Process identifier
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                resource_type_id:
                  type: string
                  minLength: 1
                  description: >-
                    Identifier of the disk resource type, which sets the disk
                    size. Use the List Disk Resource Types endpoint to retrieve
                    available options. A disk can grow but cannot shrink.
                  example: fb5e5168-4281-4bec-94c5-0d1584e9e657
                mount_path:
                  type: string
                  description: >-
                    Path inside the container where the disk is mounted. Only
                    letters, numbers, `-`, `_`, `.` and `/` are allowed, and
                    `/etc`, `/var`, `/lib`, `/usr/local`, `/mnt`, `/root`,
                    `/app`, `/workspace` and `/layers` themselves cannot be
                    used.
                  example: /var/lib/data
              required:
                - resource_type_id
                - mount_path
      responses:
        '200':
          description: >-
            Persistent disk attached to the process, which keeps its data across
            deployments and restarts. null when the process has no disk.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      resource_type_id:
                        type: string
                        description: Unique identifier for the disk resource type
                        example: fb5e5168-4281-4bec-94c5-0d1584e9e657
                      resource_type_name:
                        type: string
                        description: Name of the disk resource type (disk size)
                        example: ps1
                      size_gib:
                        type: integer
                        minimum: 1
                        maximum: 9007199254740991
                        description: Disk size in GiB
                        example: 10
                      mount_path:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Path inside the container where the disk is mounted
                        example: /var/lib/data
                    required:
                      - resource_type_id
                      - resource_type_name
                      - size_gib
                      - mount_path
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Persistent disk attached to the process, which keeps its data
                  across deployments and restarts. null when the process has no
                  disk.
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Bad request
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 400
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Unauthorized
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 401
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: >-
                      This API key is missing the <RESOURCE>:<ACTION>
                      permission. Grant it to the key or use a key that has it.
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 403
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Not found
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 404
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Too many requests
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 429
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Internal Server Error
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 500
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication. Pass your API key as a Bearer token in the
        Authorization header.

````

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