Admin23

Agent Permissions4

API Keys1

Apps6

Authentication27

Automations20

Bootstrap4

Capability Sources71

Cloud4

Codemode Runs2

Config Objects16

Connectors30

Deprecated12

Desktop Policies8

Diagnostics3

Direct uploads6

Documents12

Gateway Usage Limits16

GitHub11

Inference15

Inference Providers40

Internal19

Invitations5

LLM Providers18

Managed deployments8

Marketplaces17

Members3

OAuth16

Organizations25

Permissions11

Plugins20

Resources2

SCIM16

SSO12

System4

Teams7

Telemetry4

Users7

Webhooks4

Workbot3

Workers3

Workflow Runs1

Workflows11

Managed deployments

Prepare an install, retry or approved update

Changed on Oct 15, 2026

Creates or reuses an installer run pinned to the published release and returns handoff: the one step the person takes in their own cloud. open_link: give them handoff.url to approve. run_in_cloud_shell: give them handoff.url and handoff.command to paste. OpenWork never runs it; repeating this call reopens the same pending run.

post/v1/managed-deployments/{deploymentId}/launch

Request

Base URL: https://api.openworklabs.com
URL: https://api.openworklabs.com/v1/managed-deployments/{deploymentId}/launch
Auth: one of:
- API key in header x-api-key
- HTTP bearer

Path parameters

deploymentIdstring uuid required

Request body

kind'install' | 'update' | 'retry'

Response

Prepare an install, retry or approved update

kind'install' | 'update' | 'retry' required

approvalUrlstring uri nullable required

commandstring nullable required

expiresAtstring date-time required

Changes

Oct 15, 2026370f072eddd0 Revision changes
- info
  added the optional property to the response with the status
Oct 14, 20260005cd4e85a8 Revision changes
- breaking
  added subschema #1 subschema #2 to the response property oneOf list for the response status
- breaking
  the response's property type changed from object to no type for status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status

Operation history (3 revisions)