Docs
History
Schema
Generate

Filter operations

AdminGate2

Agents62

AI Applications31

AI Chat87

get/ai/applications/{public_id}/blueprintThe workspace's architecture blueprint with the live state of its parts.
put/ai/applications/{public_id}/blueprint/bindings/{component_id}Bind a part of the accepted blueprint to the project or service that realises it.
delete/ai/applications/{public_id}/blueprint/bindings/{component_id}Remove a part's binding. The project or service itself is untouched.
get/ai/applications/{public_id}/blueprint/versionsEvery version of the workspace's blueprint, newest first.
post/ai/applications/{public_id}/blueprint/versionsSave a version the user wrote. It replaces the accepted version (and any open proposal) as it is saved.
post/ai/applications/{public_id}/blueprint/versions/{version}/acceptAccept a proposed version: every chat of the workspace builds against it.
post/ai/applications/{public_id}/blueprint/versions/{version}/rejectReject a proposed version. The accepted version, if any, stays.
post/ai/assistant/conversationsStart a chat with the Temps assistant.
get/ai/conversationsList the current user's active conversations across all projects, most-recently-active first, annotated with project name/slug.
post/ai/conversationsCreate a private user-owned operator thread without binding its lifetime or authority to a project. Project access is selected per tool call and checked against the user's current role and memberships.
get/ai/conversations/{public_id}Load one bounded history page for a private conversation by its owner-facing id. Project/application context is revalidated, but never used as the ownership key.
patch/ai/conversations/{public_id}
post/ai/conversations/{public_id}/archive
post/ai/conversations/{public_id}/attachment-uploadsStart uploading a file in chunks, for clients behind a small request-size limit. Send the chunks in order, then complete.
delete/ai/conversations/{public_id}/attachment-uploads/{upload_id}Abandon an upload and free what it reserved.
put/ai/conversations/{public_id}/attachment-uploads/{upload_id}/chunkAppend the next chunk of an upload.
post/ai/conversations/{public_id}/attachment-uploads/{upload_id}/completeFinish an upload once every byte has arrived. The file is stored as a single-request upload would store it, and described the same way.
post/ai/conversations/{public_id}/attachments
get/ai/conversations/{public_id}/attachments/{attachment_id}
post/ai/conversations/{public_id}/compactSummarize the chat's older messages now. The full transcript stays on screen; only what the model is sent on later turns shrinks.
get/ai/conversations/{public_id}/diagnosticsExport the bounded, server-redacted diagnostic state Temps currently owns.
get/ai/conversations/{public_id}/goalsList the goals a chat is watching or has finished with, newest first.
post/ai/conversations/{public_id}/goals/{goal_id}/cancelStop watching a goal. The check never runs again and no fix turn starts.
post/ai/conversations/{public_id}/goals/{goal_id}/retryGive a failed or waiting goal a fresh attempt budget and check it again now.
post/ai/conversations/{public_id}/messagesSubmit a turn to a user-owned conversation. The authenticated user's current role and permissions are captured for this turn's tool executor; no project id from the browser is trusted or required.
get/ai/conversations/{public_id}/operationsThe deployments, backups and restores this chat started, newest first, with their current state. Only what the caller may still read is listed: deployments of projects they can access, and backups and restores when they can read backups.
get/ai/conversations/{public_id}/pending-actions
post/ai/conversations/{public_id}/permission-mode
post/ai/conversations/{public_id}/permissions/{permission_id}/resolve
get/ai/conversations/{public_id}/resourcesThe projects, databases and services, repositories and sandbox this chat made, with their current state. Projects the caller can no longer read are left out, and so are services attached only to such projects.
post/ai/conversations/{public_id}/restoreRestore a user-owned archived conversation.
get/ai/conversations/{public_id}/sandboxWhether the chat can use a sandbox, and which one it is linked to.
post/ai/conversations/{public_id}/sandboxLink a sandbox to the chat, or create one for it. Replaces any earlier link.
delete/ai/conversations/{public_id}/sandboxUnlink the chat's sandbox. The sandbox itself is left running.
get/ai/conversations/{public_id}/sandbox/changesThe uncommitted Git changes of every repository under the sandbox work directory.
get/ai/conversations/{public_id}/sandbox/changes/diffBoth sides of one changed file: as last committed, and as it is now.
post/ai/conversations/{public_id}/sandbox/changes/trackPut a folder of the sandbox under Git, so its changes show from now on: a `.gitignore` for dependencies, builds and `.env` files when it has none, then a first commit of what is there. A folder already inside a repository is refused with `409`.
get/ai/conversations/{public_id}/sandbox/fileOne file of the chat's sandbox, for the viewer. Text is cut at 1 MiB; binary files come back without content.
get/ai/conversations/{public_id}/sandbox/filesList one directory of the chat's sandbox: folders first, then files.
post/ai/conversations/{public_id}/sandbox/projectsLet the chat's sandbox use a project's database.
delete/ai/conversations/{public_id}/sandbox/projects/{project_id}Stop the chat's sandbox using a project's database.
post/ai/conversations/{public_id}/sandbox/servicesLet the chat's sandbox use one service, whether or not it belongs to a project. The service must be one the sandbox can get credentials of its own on; the variables commands receive are the same a deployment gets.
delete/ai/conversations/{public_id}/sandbox/services/{service_id}Stop the chat's sandbox using one service. Its data is left as it is.
post/ai/conversations/{public_id}/sandbox/wakeStart the chat's sandbox if it went to sleep, so the preview and the assistant's next command find it up. Does nothing when it is already running.
get/ai/conversations/{public_id}/secretsList the credentials this chat has asked for and not yet used up or lost.
put/ai/conversations/{public_id}/secrets/{secret_id}Provide the credential the assistant asked for.
post/ai/conversations/{public_id}/secrets/{secret_id}/discardDiscard a credential request and anything already typed into it.
post/ai/conversations/{public_id}/stop
get/ai/conversations/{public_id}/suggestion-modeA chat's next-step suggestion setting, with the default it falls back to.
put/ai/conversations/{public_id}/suggestion-modeSet a chat's own next-step suggestion mode, or clear it to follow the user's default.
post/ai/conversations/{public_id}/suggestionsSuggest a few next steps after the chat's latest answer. The first request for an answer makes one small request to the chat's model, with only the last question and answer, and its cost counts toward the chat's spend. The result is saved on the answer, and later requests for it return the saved set at no cost.
get/ai/conversations/{public_id}/usageWhat this conversation has cost so far.
get/ai/conversations/{public_id}/workspaceThe workspace this chat is in, with its other chats.
put/ai/conversations/{public_id}/workspacePut this chat in a workspace, creating it when asked. The chats of a workspace share its sandbox, projects and architecture blueprint.
delete/ai/conversations/{public_id}/workspaceTake this chat out of its workspace. It stops using the workspace's sandbox; the workspace and its other chats are unchanged.
get/ai/pending-actions/{action_public_id}
post/ai/pending-actions/{action_public_id}/confirm
post/ai/pending-actions/{action_public_id}/reject
get/ai/preferences/suggestionsThe user's default for next-step suggestions.
put/ai/preferences/suggestionsSet the user's default for every chat that does not set its own mode.
post/ai/preview/authorizeRenew a managed preview only for an already-bound, running workspace. The requested sandbox ID is an object selector, never an authorization grant.
get/ai/workspace
get/ai/workspace-activityAggregate all active threads for the caller's global workspace and up to 100 requested, visible application workspaces. Thread history is not paged.
get/ai/workspace/changes
get/ai/workspace/diff
get/ai/workspace/directory
get/ai/workspace/file
get/ai/workspace/file-limitsGet effective AI workspace file limits
get/ai/workspace/file/downloadDownload one global AI workspace file
post/ai/workspace/filesUpload files into the global AI workspace
post/ai/workspace/preview-linkMint a short-lived preview URL for a port in the user's shared global AI workspace. The gateway grant is identical to application previews; the only difference is how the owning sandbox is resolved.
get/ai/workspace/terminalAttach an interactive terminal to the user's global workspace
get/projects/{project_id}/ai/conversationsFind the current user's existing chat for a context (returns `null` if none yet). Conversations are private even between members of the same project.
post/projects/{project_id}/ai/conversationsGet-or-create the current user's private chat for a context.
get/projects/{project_id}/ai/conversations/listList the current user's active conversations for a project, most-recently-active first.
get/projects/{project_id}/ai/conversations/{public_id}One bounded conversation-history page (excluding internal context rows).
patch/projects/{project_id}/ai/conversations/{public_id}Rename a conversation (set its human-facing title).
post/projects/{project_id}/ai/conversations/{public_id}/archiveArchive (soft-delete) a conversation.
post/projects/{project_id}/ai/conversations/{public_id}/messagesSubmit a user message and start a server-owned turn. The command returns as soon as the turn is durable; subscribe to the conversation WebSocket for real-time output.
get/projects/{project_id}/ai/conversations/{public_id}/pending-actionsList all pending actions for a conversation (most-recently-proposed first).
post/projects/{project_id}/ai/conversations/{public_id}/permission-mode
post/projects/{project_id}/ai/conversations/{public_id}/permissions/{permission_id}/resolve
post/projects/{project_id}/ai/conversations/{public_id}/stopExplicitly cancel the server-owned active turn. Closing or refreshing a browser only detaches its stream; this endpoint is the sole UI cancellation path so execution lifetime is not coupled to connectivity.
get/projects/{project_id}/ai/pending-actions/{action_public_id}Get a single pending action by its public id (scoped to the project).
post/projects/{project_id}/ai/pending-actions/{action_public_id}/confirmConfirm a proposed AI action: validate permission, atomically claim, execute, persist outcome. The execution uses the CONFIRMING user's auth — never the model's.
post/projects/{project_id}/ai/pending-actions/{action_public_id}/rejectReject a proposed AI action (no execution). Status transitions to "rejected".
get/projects/{project_id}/ai/readinessReport which AI prerequisites this project satisfies.

AI Gateway14

AI Gateway Admin12

AI Gateway Limits5

AI Gateway Pricing1

AI Gateway Usage8

AI Provider Status3

Alarms14

Alerts6

Analytics43

Analytics Ingest Keys6

API Keys9

Audit Logs2

Authentication29

Autofix10

Autofixer7

Backups36

Blob6

Blob Management6

CI builder3

CI runner6

Cloud8

Compose3

Containers8

Cron Monitors6

Crons3

Custom Domains8

Dashboards5

Deployment Tokens6

Deployments25

DNS1

DNS Providers14

DNS Records4

Domains19

Email Domains12

Email Providers9

Email Tracking7

Email Validation1

Emails5

Environments2

error-alert-rules5

error-tracking10

Events13

External Images7

External Services50

External Services - Query9

Feature Flags9

feedback4

Files1

Funnels7

GenAI2

geo2

Git Provider Connections6

Git Providers35

HTTP Checks12

Imports5

ingestion-health1

Insights1

Internal DNS2

IP Access Control6

KV Management6

KV Store7

Load Balancer5

Logs11

Metrics17

Nodes28

Notification Preferences4

Notification Providers15

Notification Routes7

Observability2

Operations1

OTel15

OTel Facets4

OTel Ingest6

Performance6

Platform6

Postgres Upgrades7

Presets2

Preview Gateway6

Project Groups22

Project IP Access8

Projects47

Proxy Logs14

Public Repositories6

releases1

Repositories6

Restore6

Revenue16

Runtime health3

Sandboxes40

Secrets7

sentry-compat8

sentry-ingestor5

Settings16

Snapshots5

source-maps8

Static Bundles4

Status Page32

Teams13

Telemetry2

Telemetry Logs1

Telemetry Metrics4

Templates7

Traces8

Traefik Discovery6

Traffic Delivery11

Users13

Visitor Activity5

Vulnerability Scans8

Webhook Deliveries3

Webhooks6

Workflows1

get/projects/{project_id}/dsnsList all DSNs for a project
post/projects/{project_id}/dsnsCreate a new DSN for a project
post/projects/{project_id}/dsns/get-or-createGet or create DSN for a project/environment/deployment combination
post/projects/{project_id}/dsns/{dsn_id}/regenerateRegenerate DSN keys (rotate keys)
post/projects/{project_id}/dsns/{dsn_id}/revokeRevoke (deactivate) a DSN

AI Chat

Changes to The user's default for next-step suggestions.

get/ai/preferences/suggestions

Oct 20, 202679089e9f49ee Revision changes
- info
  endpoint added