Quadrillion runtime_mutations API
The runtime_mutations API from Quadrillion — 131 operation(s) for runtime_mutations.
The runtime_mutations API from Quadrillion — 131 operation(s) for runtime_mutations.
openapi: 3.1.0
info:
title: Quadrillion Cloud account runtime_mutations API
description: Public cloud API service for cloud-safe backend endpoints
version: 0.1.0
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 Endpoint
description: Get required variables for a session from Task DAG state.
operationId: get_session_req
# --- 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