/

Docs
History
Schema
Generate

Filter operations

Authentication5

v1208

post/v1/memoryAdd Memory V1
get/v1/memory/status/{memory_id}Get Memory Status
get/v1/memory/batch/status/{batch_id}Get Batch Memory Status
get/v1/memory/{memory_id}Get Memory V1
put/v1/memory/{memory_id}Update Memory V1
delete/v1/memory/{memory_id}Delete Memory V1
post/v1/memory/batchAdd Memory Batch V1
delete/v1/memory/allDelete All Memories V1
post/v1/memory/searchSearch V1
get/v1/userList Users
post/v1/userCreate User
get/v1/user/{user_id}Get User
put/v1/user/{user_id}Update User
delete/v1/user/{user_id}Delete User
post/v1/user/batchCreate User Batch
post/v1/feedbackSubmit Feedback V1
post/v1/feedback/batchSubmit Batch Feedback V1
get/v1/feedback/{feedback_id}Get Feedback By Id V1
get/v1/schemasList User Schemas V1
post/v1/schemasCreate User Schema V1
get/v1/schemas/{schema_id}Get User Schema V1
put/v1/schemas/{schema_id}Update User Schema V1
delete/v1/schemas/{schema_id}Delete User Schema V1
post/v1/messagesStore Message
get/v1/messages/sessions/{session_id}Get Session History
patch/v1/messages/sessions/{session_id}Update Session
get/v1/messages/sessions/{session_id}/statusGet Session Status
get/v1/messages/sessions/{session_id}/compressCompress Session
post/v1/messages/sessions/{session_id}/processProcess Session Messages
post/v1/omo/exportExport memories to OMO format
post/v1/omo/importImport memories from OMO format
get/v1/omo/export.jsonExport memories as .omo.json file
get/v1/namespaceList Namespaces
post/v1/namespaceCreate Namespace
get/v1/namespace/{namespace_id}Get Namespace
put/v1/namespace/{namespace_id}Update Namespace
delete/v1/namespace/{namespace_id}Delete Namespace
post/v1/namespace/{namespace_id}/api-keysCreate Namespace Api Key
post/v1/graph/transformProducer endpoint -- text -> phases + signals + embeddings
post/v1/graph/rerankRerank candidate documents against a query
get/v1/namespace/{namespace_id}/instanceGet Namespace Instance Config
put/v1/namespace/{namespace_id}/instanceSet Namespace Instance Config
delete/v1/namespace/{namespace_id}/instanceDelete Namespace Instance Config
get/v1/organization/instanceGet Organization Instance Config
put/v1/organization/instanceSet Organization Instance Config
delete/v1/organization/instanceDelete Organization Instance Config
post/v1/ai/openai/chat/completionsOpenai Completions Proxy
post/v1/ai/openai/responsesOpenai Responses Proxy
post/v1/ai/anthropic/messagesAnthropic Messages Proxy
post/v1/ai/google/models/{model_id}:generateContentGoogle Generate Content Proxy
post/v1/ai/google/models/{model_id}:streamGenerateContentGoogle Stream Generate Content Proxy
post/v1/ai/zai/chat/completionsZai Completions Proxy
post/v1/ai/groq/chat/completionsGroq Completions Proxy
post/v1/ai/moonshot/chat/completionsMoonshot Completions Proxy
get/v1/ai/usageGet Ai Usage
post/v1/typesafe/systemoneTypesafe Systemone Proxy
post/v1/files/ticketsMint an upload URL
post/v1/files/commitVerify an upload
post/v1/files/read-urlSigned read URL
post/v1/files/visibilityPublish/unpublish
post/v1/files/deleteDelete a file
post/v1/files/usageStorage used by an app
get/v1/embeddings/modelsList available Papr embedding models
post/v1/embeddingsCreate query or document embeddings
get/v1/embeddings/band-schemasList available domains (builtins + caller's custom domains)
post/v1/embeddings/band-schemasCreate a custom domain
get/v1/embeddings/band-schemas/{domain_id}/catalogGet the curated signal catalog for a domain
post/v1/embeddings/band-schemas/{domain_id}/catalog/refreshTrigger LLM clustering on buffered signal values
get/v1/embeddings/band-schemas/{domain_id}Get a single domain by id
put/v1/embeddings/band-schemas/{domain_id}Update name, description, or signal_multipliers for a custom domain
delete/v1/embeddings/band-schemas/{domain_id}Delete a custom domain
post/v1/sync/tiersGet Sync Tiers
get/v1/sync/deltaGet Sync Delta
post/v1/telemetry/eventsTelemetry Events
post/v1/platform-feedback/issuesSubmit Papr Work bug report or feature request to GitHub
post/v1/documentUpload Document
get/v1/document/status/{upload_id}Get Document Status
delete/v1/document/{upload_id}Cancel Document Processing
get/v1/graphqlGraphql Playground
post/v1/graphqlGraphql Proxy
post/v1/cloud/repos/initCreate or verify workspace repo
post/v1/cloud/repos/tokenGet short-lived git credential for workspace repos
post/v1/cloud/vault/syncSync custom keys to cloud vault
get/v1/cloud/vault/eventsStream vault change events (key names only) for the signed-in user
get/v1/cloud/vault/keysList synced vault key names (not values)
post/v1/cloud/vault/deleteDelete vault keys from cloud Secret Manager
post/v1/cloud/vault/pull-sharedPull team/org shared vault keys for desktop local mirroring
post/v1/cloud/databases/listList user's cloud databases
post/v1/cloud/databases/tokenGet auth token for a specific cloud database
post/v1/cloud/databases/deleteDelete a cloud database (e.g. unlinked job replica)
get/v1/cloud/app-reposList per-app GitHub repos in the active namespace (RepoRegistry)
get/v1/cloud/apps/{app_id}/repoGet per-app GitHub repo metadata (RepoRegistry)
post/v1/cloud/apps/{app_id}/repo/ensureEnsure per-app GitHub repo exists (idempotent)
post/v1/cloud/apps/{app_id}/repo/read-tokenScoped read-only git token for per-app repo pull (Sync V3)
post/v1/cloud/apps/{app_id}/writer-lease/acquireAcquire distributed writer lease for app-repo-writer git ops
post/v1/cloud/apps/{app_id}/writer-lease/releaseRelease distributed writer lease after git ops complete
get/v1/cloud/shards/statusPer-app repo shard pool utilization (Sync V3 Phase 1.2 ops)
get/v1/cloud/namespaces/app-split/statusNamespace app-split migration status (Sync V3 Phase 1.3)
post/v1/cloud/namespaces/app-split/migrateSplit apps/* from namespace monorepo into per-app repos
post/v1/cloud/apps/publishEnable cloud link for a mini-app
get/v1/cloud/apps/publish/{app_id}Get cloud publish config for a mini-app (owner)
delete/v1/cloud/apps/publish/{app_id}Disable cloud link for a mini-app
post/v1/cloud/apps/publish/{app_id}/completeRecord that a publish's code and database both reached the cloud (owner)
post/v1/cloud/apps/publish/{app_id}/revision-notifyTell apps.papr.ai a published app has new code (publisher only)
get/v1/cloud/apps/{app_id}/accessRole settings for a published app, and the caller's own role
put/v1/cloud/apps/{app_id}/accessReplace an app's role settings (Admins only)
get/v1/cloud/apps/resolve/{namespace_id}/{slug}Resolve a published mini-app by namespace and slug (CDN routing)
post/v1/cloud/apps/access/validateValidate Papr login or share token for cloud mini-app access
get/v1/cloud/apps/namespace/{namespace_id}/workspaceList team and public apps in a workspace namespace
get/v1/cloud/apps/shared-with-meList team apps published by others in workspaces you can access
get/v1/cloud/apps/accessibleList apps you can open from Claude, across your workspaces
get/v1/cloud/apps/teamList team-visible apps you can access in a workspace
get/v1/cloud/apps/communityList public published apps for Community catalog
post/v1/cloud/apps/installPrepare cloud app source install (fork or track)
post/v1/cloud/apps/install/db-tokenTurso token for team collaborate install (desktop, publisher primary)
post/v1/cloud/apps/changes/preparePrepare contribute-back: mint scoped git token + branch name
post/v1/cloud/apps/changes/{request_id}/publish-checkWould a direct publish (Maintainer/Admin) be allowed? Changes nothing
post/v1/cloud/apps/changes/{request_id}/submitSubmit contribute-back after branch push — opens GitHub PR
post/v1/cloud/apps/changes/{request_id}/abandonContributor: drop a prepared proposal whose push failed or had nothing to send
get/v1/cloud/apps/changes/incomingList incoming change requests for apps you own
get/v1/cloud/apps/changes/outgoingList change requests you sent (contributor side)
get/v1/cloud/apps/changes/eventsProposal status events for you (owner + contributor), after a cursor
post/v1/cloud/apps/changes/{request_id}/approveApprove a contribute-back change request (owner only)
post/v1/cloud/apps/changes/{request_id}/rejectReject a contribute-back change request (owner only)
post/v1/cloud/apps/runtime/db-tokenTurso token for app owner (Cloud App Host only)
post/v1/cloud/apps/runtime/file-urlSigned file read URL authorized by app access (Cloud App Host only)
post/v1/cloud/apps/runtime/file-uploadUpload URL for a published-app visitor, authorized by app access (Cloud App Host only)
post/v1/cloud/apps/runtime/file-commitVerify a published-app upload (Cloud App Host only)
get/v1/cloud/apps/media/{namespace_id}/{slug}/{index}Catalog cover/gallery media (redirects to a short-lived signed link)
get/v1/cloud/apps/runtime/communityPublic Community catalog for the apps.papr.ai homepage (Cloud App Host only)
post/v1/cloud/apps/runtime/share-people-allowlistPeople allowlist for a published app (Cloud App Host only)
post/v1/cloud/apps/runtime/repo-fileRead mini-app file from owner repo (Cloud App Host only)
post/v1/cloud/apps/runtime/repo-credentialsMint read-only GitHub credentials for app repo (Cloud App Host only)
post/v1/cloud/apps/runtime/vault-resolveResolve owner vs visitor vault keys (Cloud App Host / sandbox only)
post/v1/cloud/apps/runtime/vault-client-resolveResolve publishable vault keys for mini-app browser (client-safe only)
post/v1/cloud/apps/runtime/bash-runOne-shot bash for cloud mini-apps (Cloud App Host only)
post/v1/cloud/apps/runtime/job-runRun a synced job in sandbox for cloud mini-apps (Cloud App Host only)
post/v1/cloud/apps/runtime/app-agent/warmPre-warm Cloud Agent Gateway workspace for embedded app chat
post/v1/cloud/apps/runtime/app-agent/streamStream embedded app-agent chat turn via Cloud Agent Gateway SSE
post/v1/cloud/apps/runtime/jobs-listList jobs for app owner workspace (Cloud App Host only)
post/v1/cloud/apps/runtime/job-statusGet one job status for app owner workspace (Cloud App Host only)
post/v1/cloud/runtime/job-runRun a synced job in GKE sandbox (or process fallback)
get/v1/cloud/runtime/job-run/logsLive output of an in-flight job run (poll with after=next)
get/v1/cloud/runtime/jobsList jobs from git-synced workspace
delete/v1/cloud/runtime/jobs/{job_id}Remove cloud runtime catalog entry for a job (local uninstall)
post/v1/cloud/runtime/heartbeatDesktop gateway alive ping (defers cloud scheduler when fresh)
post/v1/cloud/runtime/scheduler-run-lease/acquireAcquire cross-side scheduler run lease for a job slot
post/v1/cloud/runtime/scheduler-run-lease/releaseRelease cross-side scheduler run lease after job completes
get/v1/cloud/runtime/dispatch/streamSSE push channel for job runtime patches (Phase 4b)
post/v1/cloud/runtime/job-runtime/upsertDesktop uploads local job runtime patch (Mongo LWW, no git writeback)
get/v1/cloud/runtime/job-runtimeList persisted job runtime patches for this namespace user
post/v1/cloud/runtime/turso-db-changedBump workspace sync-index after a cloud Turso write. Desktop polls sync-index on heartbeat (CDC remains source of truth).
post/v1/cloud/runtime/sessions/warmPre-warm Cloud Agent Gateway workspace for Papr Web chat
post/v1/cloud/runtime/sessions/releaseRelease Cloud Agent Gateway warm workspace when Papr Web chat tab closes
post/v1/cloud/runtime/sessions/streamUnified cloud agent session (tier=sandbox|ephemeral)
post/v1/cloud/workspace/log/appendAppend workspace log entry (Sync V3 Phase 3)
post/v1/cloud/workspace/log/append-batchAppend many workspace log entries in one request (Sync V3 batch ship)
get/v1/cloud/workspace/log/sinceRead workspace log entries after cursor
post/v1/cloud/workspace/log/genesisWrite genesis snapshot entry for a replica
get/v1/cloud/metadata/jobsLoad jobs index (Mongo first, git fallback)
put/v1/cloud/metadata/jobsUpsert config-only jobs index (Mongo LWW)
get/v1/cloud/metadata/databasesLoad databases registry (Mongo first, git fallback)
put/v1/cloud/metadata/databasesUpsert databases registry (Mongo LWW)
get/v1/cloud/metadata/subagentsLoad sub-agents index (Mongo first, git fallback)
put/v1/cloud/metadata/subagentsUpsert custom sub-agent profiles index (Mongo LWW)
get/v1/cloud/metadata/apps/{app_id}/runtime-metaLoad per-app runtime meta (Mongo first, git fallback)
put/v1/cloud/metadata/apps/{app_id}/runtime-metaUpsert per-app runtime meta (Mongo LWW)
get/v1/cloud/metadata/apps/{app_id}/db-configLoad per-app DB config (Mongo first, git fallback)
put/v1/cloud/metadata/apps/{app_id}/db-configUpsert per-app data-sources + linked-databases (Mongo LWW)
get/v1/cloud/connections/policyGet Connection Policy
patch/v1/cloud/connections/policyPatch Connection Policy
get/v1/cloud/connections/requestsList Connection Requests
post/v1/cloud/connections/requestsCreate Connection Request
post/v1/cloud/connections/requests/{request_id}/cancelCancel Connection Request
post/v1/cloud/connections/requests/{request_id}/decideDecide Connection Request
get/v1/cloud/collab/membersGet Members
get/v1/cloud/collab/mentionsList Mentions
post/v1/cloud/collab/mentionsCreate Mention
post/v1/cloud/collab/mentions/notifyNotify Mentions
get/v1/cloud/collab/mentions/{item_id}Get Mention
post/v1/cloud/collab/mentions/{item_id}/resolveResolve Mention
post/v1/cloud/collab/mentions/{item_id}/followupFollow Up Mention
get/v1/cloud/collab/focus/goalsGet Goals
put/v1/cloud/collab/focus/goalsPut Goal
get/v1/cloud/collab/focus/goals/{goal_id}/historyGet Goal History
get/v1/cloud/collab/focus/tasksGet Tasks
put/v1/cloud/collab/focus/tasksPut Task
get/v1/cloud/collab/focus/briefsList Briefs Route
get/v1/cloud/collab/focus/threeGet Three Route
put/v1/cloud/collab/focus/threePut Three Route
get/v1/cloud/collab/focus/briefs/{date}Get Brief Route
put/v1/cloud/collab/focus/briefs/{date}Put Brief
get/v1/cloud/collab/focus/prefsGet Prefs Route
put/v1/cloud/collab/focus/prefsPut Prefs Route
get/v1/cloud/collab/focus/changesGet Focus Changes
post/v1/cloud/collab/focus/importImport Route
get/v1/cloud/noticesList Notices
post/v1/cloud/noticesRaise Notice
post/v1/cloud/notices/markMark Notices
post/v1/cloud/notices/resolveResolve Notices
post/v1/cloud/oauth/sessionsStart Oauth Session
get/v1/cloud/oauth/sessions/{session_id}Get Oauth Session
post/v1/cloud/oauth/refresh/claimClaim Oauth Token
get/v1/cloud/oauth/connectionsList Oauth Connections
delete/v1/cloud/mcp/sessionsTurn off Papr in Claude: revoke every MCP session for the caller
post/v1/cloud/handoff/codesOne-time link to continue on the Mac (10 minutes, single use)
post/v1/cloud/handoff/redeemRedeem a one-time handoff code on the Mac
post/v1/ai/cursor/runs/streamStream Cursor Run

v1

Changes to Put Three Route

put/v1/cloud/collab/focus/three

Nov 5, 2026957add0fe202 Revision changes
- info
  endpoint added