/
PA
papr-ai
Search skmtc
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
Authentication
5
v1
180
post
/v1/memory
Add 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/batch
Add Memory Batch V1
delete
/v1/memory/all
Delete All Memories V1
post
/v1/memory/search
Search V1
get
/v1/user
List Users
post
/v1/user
Create 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/batch
Create User Batch
post
/v1/feedback
Submit Feedback V1
post
/v1/feedback/batch
Submit Batch Feedback V1
get
/v1/feedback/{feedback_id}
Get Feedback By Id V1
get
/v1/schemas
List User Schemas V1
post
/v1/schemas
Create 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/messages
Store Message
get
/v1/messages/sessions/{session_id}
Get Session History
patch
/v1/messages/sessions/{session_id}
Update Session
get
/v1/messages/sessions/{session_id}/status
Get Session Status
get
/v1/messages/sessions/{session_id}/compress
Compress Session
post
/v1/messages/sessions/{session_id}/process
Process Session Messages
post
/v1/omo/export
Export memories to OMO format
post
/v1/omo/import
Import memories from OMO format
get
/v1/omo/export.json
Export memories as .omo.json file
get
/v1/namespace
List Namespaces
post
/v1/namespace
Create 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-keys
Create Namespace Api Key
post
/v1/graph/transform
Producer endpoint -- text -> phases + signals + embeddings
post
/v1/graph/rerank
Rerank candidate documents against a query
get
/v1/namespace/{namespace_id}/instance
Get Namespace Instance Config
put
/v1/namespace/{namespace_id}/instance
Set Namespace Instance Config
delete
/v1/namespace/{namespace_id}/instance
Delete Namespace Instance Config
get
/v1/organization/instance
Get Organization Instance Config
put
/v1/organization/instance
Set Organization Instance Config
delete
/v1/organization/instance
Delete Organization Instance Config
post
/v1/ai/openai/chat/completions
Openai Completions Proxy
post
/v1/ai/openai/responses
Openai Responses Proxy
post
/v1/ai/anthropic/messages
Anthropic Messages Proxy
post
/v1/ai/google/models/{model_id}:generateContent
Google Generate Content Proxy
post
/v1/ai/google/models/{model_id}:streamGenerateContent
Google Stream Generate Content Proxy
post
/v1/ai/zai/chat/completions
Zai Completions Proxy
post
/v1/ai/groq/chat/completions
Groq Completions Proxy
post
/v1/ai/moonshot/chat/completions
Moonshot Completions Proxy
get
/v1/ai/usage
Get Ai Usage
post
/v1/typesafe/systemone
Typesafe Systemone Proxy
post
/v1/files/tickets
Mint an upload URL
post
/v1/files/commit
Verify an upload
post
/v1/files/read-url
Signed read URL
post
/v1/files/visibility
Publish/unpublish
post
/v1/files/delete
Delete a file
post
/v1/files/usage
Storage used by an app
get
/v1/embeddings/models
List available Papr embedding models
post
/v1/embeddings
Create query or document embeddings
get
/v1/embeddings/band-schemas
List available domains (builtins + caller's custom domains)
post
/v1/embeddings/band-schemas
Create a custom domain
get
/v1/embeddings/band-schemas/{domain_id}/catalog
Get the curated signal catalog for a domain
post
/v1/embeddings/band-schemas/{domain_id}/catalog/refresh
Trigger 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/tiers
Get Sync Tiers
get
/v1/sync/delta
Get Sync Delta
post
/v1/telemetry/events
Telemetry Events
post
/v1/platform-feedback/issues
Submit Papr Work bug report or feature request to GitHub
post
/v1/document
Upload Document
get
/v1/document/status/{upload_id}
Get Document Status
delete
/v1/document/{upload_id}
Cancel Document Processing
get
/v1/graphql
Graphql Playground
post
/v1/graphql
Graphql Proxy
post
/v1/cloud/repos/init
Create or verify workspace repo
post
/v1/cloud/repos/token
Get short-lived git credential for workspace repos
post
/v1/cloud/vault/sync
Sync custom keys to cloud vault
get
/v1/cloud/vault/events
Stream vault change events (key names only) for the signed-in user
get
/v1/cloud/vault/keys
List synced vault key names (not values)
post
/v1/cloud/vault/delete
Delete vault keys from cloud Secret Manager
post
/v1/cloud/vault/pull-shared
Pull team/org shared vault keys for desktop local mirroring
post
/v1/cloud/databases/list
List user's cloud databases
post
/v1/cloud/databases/token
Get auth token for a specific cloud database
post
/v1/cloud/databases/delete
Delete a cloud database (e.g. unlinked job replica)
get
/v1/cloud/app-repos
List per-app GitHub repos in the active namespace (RepoRegistry)
get
/v1/cloud/apps/{app_id}/repo
Get per-app GitHub repo metadata (RepoRegistry)
post
/v1/cloud/apps/{app_id}/repo/ensure
Ensure per-app GitHub repo exists (idempotent)
post
/v1/cloud/apps/{app_id}/repo/read-token
Scoped read-only git token for per-app repo pull (Sync V3)
post
/v1/cloud/apps/{app_id}/writer-lease/acquire
Acquire distributed writer lease for app-repo-writer git ops
post
/v1/cloud/apps/{app_id}/writer-lease/release
Release distributed writer lease after git ops complete
get
/v1/cloud/shards/status
Per-app repo shard pool utilization (Sync V3 Phase 1.2 ops)
get
/v1/cloud/namespaces/app-split/status
Namespace app-split migration status (Sync V3 Phase 1.3)
post
/v1/cloud/namespaces/app-split/migrate
Split apps/* from namespace monorepo into per-app repos
post
/v1/cloud/apps/publish
Enable 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}/complete
Record that a publish's code and database both reached the cloud (owner)
post
/v1/cloud/apps/publish/{app_id}/revision-notify
Tell apps.papr.ai a published app has new code (publisher only)
get
/v1/cloud/apps/{app_id}/access
Role settings for a published app, and the caller's own role
put
/v1/cloud/apps/{app_id}/access
Replace 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/validate
Validate Papr login or share token for cloud mini-app access
get
/v1/cloud/apps/namespace/{namespace_id}/workspace
List team and public apps in a workspace namespace
get
/v1/cloud/apps/shared-with-me
List team apps published by others in workspaces you can access
get
/v1/cloud/apps/accessible
List apps you can open from Claude, across your workspaces
get
/v1/cloud/apps/team
List team-visible apps you can access in a workspace
get
/v1/cloud/apps/community
List public published apps for Community catalog
post
/v1/cloud/apps/install
Prepare cloud app source install (fork or track)
post
/v1/cloud/apps/install/db-token
Turso token for team collaborate install (desktop, publisher primary)
post
/v1/cloud/apps/changes/prepare
Prepare contribute-back: mint scoped git token + branch name
post
/v1/cloud/apps/changes/{request_id}/publish-check
Would a direct publish (Maintainer/Admin) be allowed? Changes nothing
post
/v1/cloud/apps/changes/{request_id}/submit
Submit contribute-back after branch push — opens GitHub PR
get
/v1/cloud/apps/changes/incoming
List incoming change requests for apps you own
get
/v1/cloud/apps/changes/outgoing
List change requests you sent (contributor side)
get
/v1/cloud/apps/changes/events
Proposal status events for you (owner + contributor), after a cursor
post
/v1/cloud/apps/changes/{request_id}/approve
Approve a contribute-back change request (owner only)
post
/v1/cloud/apps/changes/{request_id}/reject
Reject a contribute-back change request (owner only)
post
/v1/cloud/apps/runtime/db-token
Turso token for app owner (Cloud App Host only)
post
/v1/cloud/apps/runtime/file-url
Signed file read URL authorized by app access (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/community
Public Community catalog for the apps.papr.ai homepage (Cloud App Host only)
post
/v1/cloud/apps/runtime/share-people-allowlist
People allowlist for a published app (Cloud App Host only)
post
/v1/cloud/apps/runtime/repo-file
Read mini-app file from owner repo (Cloud App Host only)
post
/v1/cloud/apps/runtime/repo-credentials
Mint read-only GitHub credentials for app repo (Cloud App Host only)
post
/v1/cloud/apps/runtime/vault-resolve
Resolve owner vs visitor vault keys (Cloud App Host / sandbox only)
post
/v1/cloud/apps/runtime/vault-client-resolve
Resolve publishable vault keys for mini-app browser (client-safe only)
post
/v1/cloud/apps/runtime/bash-run
One-shot bash for cloud mini-apps (Cloud App Host only)
post
/v1/cloud/apps/runtime/job-run
Run a synced job in sandbox for cloud mini-apps (Cloud App Host only)
post
/v1/cloud/apps/runtime/app-agent/warm
Pre-warm Cloud Agent Gateway workspace for embedded app chat
post
/v1/cloud/apps/runtime/app-agent/stream
Stream embedded app-agent chat turn via Cloud Agent Gateway SSE
post
/v1/cloud/apps/runtime/jobs-list
List jobs for app owner workspace (Cloud App Host only)
post
/v1/cloud/apps/runtime/job-status
Get one job status for app owner workspace (Cloud App Host only)
post
/v1/cloud/runtime/job-run
Run a synced job in GKE sandbox (or process fallback)
get
/v1/cloud/runtime/job-run/logs
Live output of an in-flight job run (poll with after=next)
get
/v1/cloud/runtime/jobs
List 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/heartbeat
Desktop gateway alive ping (defers cloud scheduler when fresh)
post
/v1/cloud/runtime/scheduler-run-lease/acquire
Acquire cross-side scheduler run lease for a job slot
post
/v1/cloud/runtime/scheduler-run-lease/release
Release cross-side scheduler run lease after job completes
get
/v1/cloud/runtime/dispatch/stream
SSE push channel for job runtime patches (Phase 4b)
post
/v1/cloud/runtime/job-runtime/upsert
Desktop uploads local job runtime patch (Mongo LWW, no git writeback)
get
/v1/cloud/runtime/job-runtime
List persisted job runtime patches for this namespace user
post
/v1/cloud/runtime/turso-db-changed
Bump workspace sync-index after a cloud Turso write. Desktop polls sync-index on heartbeat (CDC remains source of truth).
post
/v1/cloud/runtime/sessions/warm
Pre-warm Cloud Agent Gateway workspace for Papr Web chat
post
/v1/cloud/runtime/sessions/release
Release Cloud Agent Gateway warm workspace when Papr Web chat tab closes
post
/v1/cloud/runtime/sessions/stream
Unified cloud agent session (tier=sandbox|ephemeral)
post
/v1/cloud/workspace/log/append
Append workspace log entry (Sync V3 Phase 3)
post
/v1/cloud/workspace/log/append-batch
Append many workspace log entries in one request (Sync V3 batch ship)
get
/v1/cloud/workspace/log/since
Read workspace log entries after cursor
post
/v1/cloud/workspace/log/genesis
Write genesis snapshot entry for a replica
get
/v1/cloud/metadata/jobs
Load jobs index (Mongo first, git fallback)
put
/v1/cloud/metadata/jobs
Upsert config-only jobs index (Mongo LWW)
get
/v1/cloud/metadata/databases
Load databases registry (Mongo first, git fallback)
put
/v1/cloud/metadata/databases
Upsert databases registry (Mongo LWW)
get
/v1/cloud/metadata/subagents
Load sub-agents index (Mongo first, git fallback)
put
/v1/cloud/metadata/subagents
Upsert custom sub-agent profiles index (Mongo LWW)
get
/v1/cloud/metadata/apps/{app_id}/runtime-meta
Load per-app runtime meta (Mongo first, git fallback)
put
/v1/cloud/metadata/apps/{app_id}/runtime-meta
Upsert per-app runtime meta (Mongo LWW)
get
/v1/cloud/metadata/apps/{app_id}/db-config
Load per-app DB config (Mongo first, git fallback)
put
/v1/cloud/metadata/apps/{app_id}/db-config
Upsert per-app data-sources + linked-databases (Mongo LWW)
get
/v1/cloud/connections/policy
Get Connection Policy
patch
/v1/cloud/connections/policy
Patch Connection Policy
get
/v1/cloud/connections/requests
List Connection Requests
post
/v1/cloud/connections/requests
Create Connection Request
post
/v1/cloud/connections/requests/{request_id}/cancel
Cancel Connection Request
post
/v1/cloud/connections/requests/{request_id}/decide
Decide Connection Request
post
/v1/cloud/oauth/sessions
Start Oauth Session
get
/v1/cloud/oauth/sessions/{session_id}
Get Oauth Session
post
/v1/cloud/oauth/refresh/claim
Claim Oauth Token
get
/v1/cloud/oauth/connections
List Oauth Connections
delete
/v1/cloud/mcp/sessions
Turn off Papr in Claude: revoke every MCP session for the caller
post
/v1/cloud/handoff/codes
One-time link to continue on the Mac (10 minutes, single use)
post
/v1/cloud/handoff/redeem
Redeem a one-time handoff code on the Mac
post
/v1/ai/cursor/runs/stream
Stream Cursor Run
v1
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Acquire distributed writer lease for app-repo-writer git ops
post
/v1/cloud/apps/{app_id}/writer-lease/acquire
Oct 16, 2026
0e7a5c0d125d
Revision changes
info
endpoint added