Quadrillion

Quadrillion runtime_mutations API

The runtime_mutations API from Quadrillion — 131 operation(s) for runtime_mutations.

GitHub OpenAPI

Operations 143

GET /api/projects/{project_id}/knowledge-summary Get Project Knowledge Summary #
POST /api/evidence Add Evidence Endpoint #
GET /models Get Available Models #
GET /sessions List Sessions #
PATCH /sessions/{chat_session_id} Update Session #
POST /chat/{chat_session_id}/stop Stop Chat Session #
POST /chat/{chat_session_id}/resume Resume Chat Session #
POST /chat-sessions/{chat_session_id}/info Get Chat Session Info #
POST /chat-sessions/{chat_session_id}/replay Replay Chat History #
POST /chat-sessions/{chat_session_id}/pending-user-inputs List Pending User Inputs For Session #
POST /chat-sessions/delete Delete Chat Sessions #
POST /chat/{chat_session_id}/attach Attach Notebook To Chat #
POST /chat/{chat_session_id}/detach Detach Notebook From Chat #
GET /notebooks/{notebook_id}/active-session-id Get Active Session Id #
GET /api/skills Get Skills #
POST /notebook Read Notebook #
GET /notebook Read Notebook Get #
POST /notebook/beta/draft/manifest Get Draft Manifest #
POST /notebook/draft/manifest Get Draft Manifest #
POST /notebook/beta/draft/cells Get Draft Cells #
POST /notebook/draft/cells Get Draft Cells #
POST /notebook/beta/draft/operations Submit Draft Operations #
POST /notebook/draft/operations Submit Draft Operations #
POST /notebook/cell Patch Notebook Cell #
POST /notebook/cell/add Add Notebook Cell #
POST /notebook/draft Save Draft #
POST /notebook/draft/reset-to-canonical Reset Draft To Canonical #
POST /notebook/draft/save-to-canonical Save Draft To Canonical #
POST /notebook/save Save Or Export Notebook Route #
POST /notebook/create Create File Route #
POST /notebook/delete Delete Path Route #
GET /notebooks List Notebooks #
POST /notebooks Create Folder #
GET /notebooks/recent List Recent Notebooks #
GET /notebook/check-path Check Path Exists #
GET /list-files List Files #
GET /list-all-files List All Files #
POST /fs/rename Rename Path Route #
GET /notebook/id Get Notebook Id #
POST /fs/duplicate Duplicate Path Route #
POST /fs/reveal Reveal Path Route #
POST /fs/open-with-default Open With Default Route #
GET /api/session/{session_id}/required_variables Get Session Required Variables Endpoint #
POST /api/notebook/export_standalone Export Notebook Standalone Endpoint #
POST /api/notebook/export_content Export Notebook Content Endpoint #
POST /api/notebook/export_folder Export Folder Notebooks Endpoint #
POST /files/upload Upload File #
GET /files/download Download File #
GET /api/projects/{project_id}/export Export Project Endpoint #
POST /api/projects/import Import Project Endpoint #
GET /execute/{execution_id}/replay Replay Execution Output #
POST /execute Execute #
POST /api/terminal/create Create Terminal #
POST /api/terminal/{terminal_id}/write Write Terminal #
GET /api/terminal/{terminal_id}/read Read Terminal #
POST /api/terminal/{terminal_id}/resize Resize Terminal #
DELETE /api/terminal/{terminal_id} Delete Terminal #
GET /api/terminal/python-env Get Python Env #
POST /api/terminal/{terminal_id}/qualia Qualia Command #
POST /api/settings/update Update Single Setting Handler #
POST /api/settings/apply-model-family Apply Model Family Handler #
GET /api/settings/values Get All Settings Handler #
GET /api/settings/base-path Get Base Path Handler #
POST /api/workspace/switch Switch Workspace Handler #
GET /api/settings/environment/status Get Environment Status Handler #
GET /api/settings/environment/preparation-status Get Environment Preparation Status Handler #
POST /api/settings/environment/prepare Prepare Environment Handler #
POST /api/settings/environment/cancel-prepare Cancel Prepare Environment Handler #
POST /api/settings/environment/cleanup-prepared Cleanup Prepared Environment Handler #
GET /api/settings/environment/config Get Environment Config Handler #
PUT /api/settings/environment/config Update Environment Config Handler #
PUT /api/settings/environment/private-values Update Environment Private Values Handler #
GET /api/python-environments/check-venv Check Venv Handler #
GET /api/python-environments/create-location Get Create Environment Location Handler #
GET /api/settings/slack/configured Get Slack Configured Handler #
POST /api/settings/slack/install Slack Oauth Init Handler #
POST /api/settings/slack/oauth-callback Slack Oauth Callback Handler #
GET /api/settings/github/configured Get Github Configured Handler #
POST /api/settings/github/install Github Oauth Init Handler #
POST /api/settings/github/oauth-callback Github Oauth Callback Handler #
GET /api/settings/validate-kernel Validate Kernel Setting Handler #
GET /api/kernel-discovery/paths List Kernel Discovery Paths Handler #
POST /api/kernel-discovery/paths Add Kernel Discovery Path Handler #
POST /api/kernel-discovery/paths/preview Preview Kernel Discovery Path Handler #
POST /api/kernel-discovery/paths/{path_id}/enabled Set Kernel Discovery Path Enabled Handler #
DELETE /api/kernel-discovery/paths/{path_id} Remove Kernel Discovery Path Handler #
POST /api/python-environments/select Select Python Environment Handler #
POST /api/julia-environments/select Select Julia Environment Handler #
POST /api/r-environments/select Select R Environment Handler #
GET /api/python-environments/create-status Get Create Environment Status #
POST /api/python-environments/create Create Python Environment Handler #
DELETE /api/python-environments/workspace-venv Delete Python Environment Handler #
GET /api/settings/matplotlibrc Get Matplotlibrc Handler #
POST /api/settings/matplotlibrc Update Matplotlibrc Handler #
GET /api/settings/matplotlibrc/path Get Matplotlibrc Path Handler #
GET /api/settings/matplotlibrc/color-cycles Get Color Cycle Schemes Handler #
POST /api/settings/matplotlibrc/color-cycles/custom Save Custom Color Scheme Handler #
DELETE /api/settings/matplotlibrc/color-cycles/custom/{scheme_id} Delete Custom Color Scheme Handler #
GET /api/settings/matplotlibrc/colormaps Get Colormap Preview Handler #
GET /api/settings/bash-allowlist Get Bash Allowlist Handler #
POST /api/settings/bash-allowlist Add Bash Allowlist Handler #
DELETE /api/settings/bash-allowlist Clear Bash Allowlist Handler #
DELETE /api/settings/bash-allowlist/{command} Remove Bash Allowlist Handler #
GET /api/settings/sandbox Get Sandbox Settings Handler #
POST /api/settings/sandbox Update Sandbox Settings Handler #
GET /api/settings/sandbox/status Get Sandbox Status Handler #
GET /api/credentials/status Get Credentials Status #
PUT /api/credentials/{key} Store Credential Handler #
DELETE /api/credentials/{key} Delete Credential Handler #
GET /tags Get Available Tags Handler #
POST /tags/create Create Tag Handler #
POST /tags/update Update Tag Handler #
POST /tags/delete Delete Tag Handler #
GET /api/rules Get Rules Handler #
POST /api/rules Create Rule Handler #
PUT /api/rules/{rule_id} Update Rule Handler #
DELETE /api/rules/{rule_id} Delete Rule Handler #
POST /api/rules/reveal-folder Reveal Rules Folder Handler #
POST /api/rules/import/cursor Import Cursor Rules Handler #
POST /api/rules/import/claude-code Import Claude Code Rules Handler #
POST /api/rules/import/file Import Rules From File Handler #
GET /api/rules/personas List Personas Handler #
POST /api/rules/personas/activate Activate Persona Handler #
GET /writeup/load Load Writeup #
POST /writeup/save Save Writeup #
GET /writeup/export Export Writeup #
GET /api/projects/{project_id}/claims List Project Claims #
GET /api/claims/{claim_id} Get Claim Endpoint #
DELETE /api/claims/{claim_id} Delete Claim Endpoint #
GET /api/claims/{claim_id}/dag Get Claim Dag Endpoint #
PATCH /api/projects/{project_id}/claims/{claim_id}/tabular-sort Update Tabular Sort Endpoint #
POST /api/claims/{claim_id}/review Review Claim Endpoint #
POST /api/claims/review_bulk Review Claims Bulk Endpoint #
POST /api/fetch-url Fetch Url Endpoint #
POST /api/projects/{project_id}/import-knowledge Import Knowledge Endpoint #
GET /api/projects/{project_id}/import-sources List Import Sources Endpoint #
GET /api/projects/{project_id}/import-knowledge/{import_id}/status Import Knowledge Status Endpoint #
POST /blobs/upload Upload Blob #
GET /blobs/{uuid_str} Serve Blob #
GET /blobs/{uuid_str}/download Download Blob #
POST /blobs/{uuid_str}/save-as-file Save Blob As File #
GET /autocomplete/models Get Autocomplete Models Endpoint #
POST /api/autocomplete Autocomplete #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/quadrillion/refs/heads/main/openapi/quadrillion-runtime-mutations-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/quadrillion-runtime-mutations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

quadrillion-runtime-mutations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Quadrillion Cloud account Runtime Mutations API
  description: Public cloud API service for cloud-safe backend endpoints
  version: 0.1.0
servers:
- url: https://api.quadrillion.io
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: runtime_mutations
paths:
  /api/projects/{project_id}/knowledge-summary:
    get:
      tags:
      - runtime_mutations
      summary: Get Project Knowledge Summary
      operationId: get_project_knowledge_summary_api_projects__project_id__knowledge_summary_get
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      - name: recent_limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 0
          default: 30
          title: Recent Limit
      - name: refresh
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Refresh
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeSummaryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/evidence:
    post:
      tags:
      - runtime_mutations
      summary: Add Evidence Endpoint
      description: 'Add a notebook-captured evidence claim for an untracked variable.


        Kernel-only on both mounts: this local route requires the kernel API

        bearer token; the cloud mirror requires an internal principal.


        Rejections (unsupported value type, no session for the notebook,

        bad variable name) come back in ``rejected_reason`` rather than

        via HTTP error so the client can surface them in-cell without

        raising.'
      operationId: add_evidence_endpoint_api_evidence_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddEvidenceRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddEvidenceResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /models:
    get:
      tags:
      - runtime_mutations
      summary: Get Available Models
      operationId: get_available_models_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /sessions:
    get:
      tags:
      - runtime_mutations
      summary: List Sessions
      operationId: list_sessions_sessions_get
      parameters:
      - name: project_path
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Project Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /sessions/{chat_session_id}:
    patch:
      tags:
      - runtime_mutations
      summary: Update Session
      operationId: update_session_sessions__chat_session_id__patch
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/{chat_session_id}/stop:
    post:
      tags:
      - runtime_mutations
      summary: Stop Chat Session
      operationId: stop_chat_session_chat__chat_session_id__stop_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/{chat_session_id}/resume:
    post:
      tags:
      - runtime_mutations
      summary: Resume Chat Session
      operationId: resume_chat_session_chat__chat_session_id__resume_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat-sessions/{chat_session_id}/info:
    post:
      tags:
      - runtime_mutations
      summary: Get Chat Session Info
      operationId: get_chat_session_info_chat_sessions__chat_session_id__info_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat-sessions/{chat_session_id}/replay:
    post:
      tags:
      - runtime_mutations
      summary: Replay Chat History
      operationId: replay_chat_history_chat_sessions__chat_session_id__replay_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat-sessions/{chat_session_id}/pending-user-inputs:
    post:
      tags:
      - runtime_mutations
      summary: List Pending User Inputs For Session
      operationId: list_pending_user_inputs_for_session_chat_sessions__chat_session_id__pending_user_inputs_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat-sessions/delete:
    post:
      tags:
      - runtime_mutations
      summary: Delete Chat Sessions
      operationId: delete_chat_sessions_chat_sessions_delete_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /chat/{chat_session_id}/attach:
    post:
      tags:
      - runtime_mutations
      summary: Attach Notebook To Chat
      operationId: attach_notebook_to_chat_chat__chat_session_id__attach_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/{chat_session_id}/detach:
    post:
      tags:
      - runtime_mutations
      summary: Detach Notebook From Chat
      operationId: detach_notebook_from_chat_chat__chat_session_id__detach_post
      parameters:
      - name: chat_session_id
        in: path
        required: true
        schema:
          type: string
          title: Chat Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebooks/{notebook_id}/active-session-id:
    get:
      tags:
      - runtime_mutations
      summary: Get Active Session Id
      operationId: get_active_session_id_notebooks__notebook_id__active_session_id_get
      parameters:
      - name: notebook_id
        in: path
        required: true
        schema:
          type: string
          title: Notebook Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills:
    get:
      tags:
      - runtime_mutations
      summary: Get Skills
      operationId: get_skills_api_skills_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /notebook:
    post:
      tags:
      - runtime_mutations
      summary: Read Notebook
      description: "Load a file by path, checking for a session draft first.\n\nIf a session draft exists for this notebook:\n- Returns the draft state instead of the canonical file.\n- If the draft's canonical base revision has drifted, includes a\n  ``draft_conflict`` field so the frontend can prompt the user.\n\nNon-notebook files bypass draft logic entirely.\n\nReturns:\n- .ipynb  -> JSON: { path, cells, metadata, draft_revision?, draft_conflict? }\n- text    -> raw UTF-8 text (text/plain or application/json)\n- binary  -> raw bytes (image/*, application/pdf, etc.)"
      operationId: read_notebook_notebook_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_NotebookReadRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - runtime_mutations
      summary: Read Notebook Get
      description: GET version of /notebook endpoint for serving files in markdown img tags.
      operationId: read_notebook_get_notebook_get
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/beta/draft/manifest:
    post:
      tags:
      - runtime_mutations
      summary: Get Draft Manifest
      operationId: get_draft_manifest_notebook_beta_draft_manifest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftManifestRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft/manifest:
    post:
      tags:
      - runtime_mutations
      summary: Get Draft Manifest
      operationId: get_draft_manifest_notebook_draft_manifest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftManifestRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/beta/draft/cells:
    post:
      tags:
      - runtime_mutations
      summary: Get Draft Cells
      operationId: get_draft_cells_notebook_beta_draft_cells_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftCellsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft/cells:
    post:
      tags:
      - runtime_mutations
      summary: Get Draft Cells
      operationId: get_draft_cells_notebook_draft_cells_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftCellsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/beta/draft/operations:
    post:
      tags:
      - runtime_mutations
      summary: Submit Draft Operations
      operationId: submit_draft_operations_notebook_beta_draft_operations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftOperationsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft/operations:
    post:
      tags:
      - runtime_mutations
      summary: Submit Draft Operations
      operationId: submit_draft_operations_notebook_draft_operations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftOperationsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/cell:
    post:
      tags:
      - runtime_mutations
      summary: Patch Notebook Cell
      description: 'Apply a user cell-content edit to draft + live notebook state.


        Synchronous HTTP equivalent of the ``notebook_cell_user_edit``

        socket event. Used by the frontend to flush a pending edit before

        invoking ``/execute`` so cell-id execution sees the user''s latest

        content. A missed patch is a failed precondition for execution because

        continuing would run stale backend state.'
      operationId: patch_notebook_cell_notebook_cell_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_CellPatchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/cell/add:
    post:
      tags:
      - runtime_mutations
      summary: Add Notebook Cell
      description: 'Insert a new user-authored cell into the draft + live notebook state.


        Used by the frontend so that subsequent same-session HTTP writes

        (``/notebook/cell``, ``/execute``) are guaranteed to see the cell.


        Idempotent: re-adding an existing ``cell_id`` returns success

        without mutating the draft.'
      operationId: add_notebook_cell_notebook_cell_add_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_CellAddRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft:
    post:
      tags:
      - runtime_mutations
      summary: Save Draft
      description: 'Create or update a session draft (debounced autosave path).


        No-ops when a generation is active: the agent''s turn notebook is

        the sole draft writer, and user edits flow over the

        ``notebook_cell_user_*`` socket events.'
      operationId: save_draft_notebook_draft_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftSaveRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft/reset-to-canonical:
    post:
      tags:
      - runtime_mutations
      summary: Reset Draft To Canonical
      description: Reset a live session draft to canonical file state without deleting it.
      operationId: reset_draft_to_canonical_notebook_draft_reset_to_canonical_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftResetRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/draft/save-to-canonical:
    post:
      tags:
      - runtime_mutations
      summary: Save Draft To Canonical
      description: 'Promote a session draft to canonical.


        Outside generation: CAS conflict detection (or ``force=True``). During

        generation, ``save_to_canonical`` force-writes the live draft because the

        draft store is the notebook source of truth for user and agent edits. Either

        way the draft is preserved on success with a refreshed

        ``canonical_base_revision``.


        Any ``pending_user_edits`` are applied first via the same per-cell write

        path the ``notebook_cell_user_edit`` socket handler uses, so an explicit

        save inside the user edit debounce window is atomic with respect to the

        user''s latest typing.'
      operationId: save_draft_to_canonical_notebook_draft_save_to_canonical_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DraftSaveToCanonicalRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/save:
    post:
      tags:
      - runtime_mutations
      summary: Save Or Export Notebook Route
      description: 'Save handler for notebooks and text files.


        For notebooks, this now saves to the session draft store first, then

        promotes to canonical with CAS conflict detection.'
      operationId: save_or_export_notebook_route_notebook_save_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_FileSaveRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/create:
    post:
      tags:
      - runtime_mutations
      summary: Create File Route
      description: 'Create a new notebook or text file, failing if the path already exists.


        Unlike ``/notebook/save`` (an upsert), this endpoint refuses to overwrite

        an existing file and returns ``409 Conflict`` when ``path`` is taken.


        For ``.ipynb`` files this writes a starter notebook containing one empty

        code cell whose ``cell_id`` is minted on the backend. That avoids the

        frontend (``useNotebookLoader.makeEmptyCell``) fabricating a phantom cell

        with a client-side id when it loads a zero-cell notebook.'
      operationId: create_file_route_notebook_create_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_FileCreateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/delete:
    post:
      tags:
      - runtime_mutations
      summary: Delete Path Route
      description: Delete a file or folder under NOTEBOOK_BASE_PATH.
      operationId: delete_path_route_notebook_delete_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_FileDeleteRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebooks:
    get:
      tags:
      - runtime_mutations
      summary: List Notebooks
      description: Lists all files in a given path relative to BASE_PATH.
      operationId: list_notebooks_notebooks_get
      parameters:
      - name: path
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - runtime_mutations
      summary: Create Folder
      description: Create a folder under the given relative 'path' within BASE_PATH.
      operationId: create_folder_notebooks_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_FolderCreateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebooks/recent:
    get:
      tags:
      - runtime_mutations
      summary: List Recent Notebooks
      description: Lists the most recently modified notebooks.
      operationId: list_recent_notebooks_notebooks_recent_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 5
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/check-path:
    get:
      tags:
      - runtime_mutations
      summary: Check Path Exists
      description: Check if a file path exists.
      operationId: check_path_exists_notebook_check_path_get
      parameters:
      - name: path
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /list-files:
    get:
      tags:
      - runtime_mutations
      summary: List Files
      description: Unified endpoint for listing files and folders in a directory.
      operationId: list_files_list_files_get
      parameters:
      - name: path
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /list-all-files:
    get:
      tags:
      - runtime_mutations
      summary: List All Files
      description: 'Return a flat, sorted list of workspace-relative file paths.


        Used by the chat composer''s ``@path:`` autocomplete. Local mode only

        for now; remote/cloud flavors return an empty list until they grow a

        proper implementation.'
      operationId: list_all_files_list_all_files_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /fs/rename:
    post:
      tags:
      - runtime_mutations
      summary: Rename Path Route
      description: Rename/move a file or folder.
      operationId: rename_path_route_fs_rename_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_FileRenameRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /notebook/id:
    get:
      tags:
      - runtime_mutations
      summary: Get Notebook Id
      description: GET /notebook/id?path=<relative_path_to_ipynb>
      operationId: get_notebook_id_notebook_id_get
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /fs/duplicate:
    post:
      tags:
      - runtime_mutations
      summary: Duplicate Path Route
      description: Duplicate a file or folder.
      operationId: duplicate_path_route_fs_duplicate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_DuplicatePathRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /fs/reveal:
    post:
      tags:
      - runtime_mutations
      summary: Reveal Path Route
      description: Reveal a file or folder in the system file manager (Finder/Explorer).
      operationId: reveal_path_route_fs_reveal_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_RevealPathRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /fs/open-with-default:
    post:
      tags:
      - runtime_mutations
      summary: Open With Default Route
      description: Open a file with the system's default application.
      operationId: open_with_default_route_fs_open_with_default_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_OpenWithDefaultRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/session/{session_id}/required_variables:
    get:
      tags:
      - runtime_mutations
      summary: Get Session Required Variables E

# --- truncated at 32 KB (145 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/quadrillion/refs/heads/main/openapi/quadrillion-runtime-mutations-api-openapi.yml