---
seo:
  description: >-
    Provider-independent API for owner-managed device functions. Device
    attachment, agent access and function grants are separate permissions.
    Timestamps use Unix…
sidebar:
  label: Overview
title: openlaunch API
---
Provider-independent API for owner-managed device functions. Device attachment, agent access and function grants are separate permissions. Timestamps use Unix milliseconds. Most HTTP responses wrap data or error; health and OAuth metadata are raw objects. MCP uses its own JSON-RPC envelopes and protocol headers.

Version 1.0.0

Base URL: `https://www.openlaunch.dev`

## System

- [`GET /healthz`](/docs/reference/system/get-healthz) — Check service health.

## Owner

- [`GET /v1/account`](/docs/reference/owner/get-v1-account) — Get signed-in owner account context.
- [`GET /v1/actions`](/docs/reference/owner/get-v1-actions) — List action history.
- [`GET /v1/actions/export`](/docs/reference/owner/get-v1-actions-export) — Export action history.
- [`GET /v1/agent-connections`](/docs/reference/owner/get-v1-agent-connections) — List agent connections.
- [`POST /v1/agent-connections`](/docs/reference/owner/post-v1-agent-connections) — Create agent API connection.
- [`POST /v1/agent-connections/{connectionId}/revoke`](/docs/reference/owner/post-v1-agent-connections-connection-id-revoke) — Revoke agent connection.
- [`GET /v1/grants`](/docs/reference/owner/get-v1-grants) — List grants.
- [`POST /v1/grants`](/docs/reference/owner/post-v1-grants) — Grant device functions.
- [`POST /v1/grants/revoke`](/docs/reference/owner/post-v1-grants-revoke) — Revoke device function grant.
- [`POST /v1/devices/{deviceId}/revoke`](/docs/reference/owner/post-v1-devices-device-id-revoke) — Revoke device.

## Setup

- [`GET /v1/device-setup-tokens`](/docs/reference/setup/get-v1-device-setup-tokens) — List device setup tokens.
- [`POST /v1/device-setup-tokens`](/docs/reference/setup/post-v1-device-setup-tokens) — Create attach-only device setup token.
- [`GET /v1/sdk-tokens`](/docs/reference/setup/get-v1-sdk-tokens) — List setup tokens (legacy alias).
- [`POST /v1/sdk-tokens`](/docs/reference/setup/post-v1-sdk-tokens) — Create setup token (legacy alias).
- [`POST /v1/device-setup-tokens/{connectionId}/revoke`](/docs/reference/setup/post-v1-device-setup-tokens-connection-id-revoke) — Revoke setup token.
- [`POST /v1/sdk-tokens/{connectionId}/revoke`](/docs/reference/setup/post-v1-sdk-tokens-connection-id-revoke) — Revoke setup token (legacy alias).
- [`POST /v1/enrollments`](/docs/reference/setup/post-v1-enrollments) — Create legacy board enrollment.
- [`POST /v1/device/enroll`](/docs/reference/setup/post-v1-device-enroll) — Enroll legacy board.
- [`POST /v1/sdk/devices`](/docs/reference/setup/post-v1-sdk-devices) — Attach SDK device.

## OAuth

- [`GET /v1/oauth-clients`](/docs/reference/oauth/get-v1-oauth-clients) — List OAuth clients.
- [`POST /v1/oauth-clients`](/docs/reference/oauth/post-v1-oauth-clients) — Register OAuth client.
- [`POST /v1/oauth-clients/{clientId}/revoke`](/docs/reference/oauth/post-v1-oauth-clients-client-id-revoke) — Revoke OAuth client.
- [`GET /.well-known/oauth-protected-resource`](/docs/reference/oauth/get-well-known-oauth-protected-resource) — OAuth protected resource metadata.
- [`GET /.well-known/oauth-protected-resource/mcp`](/docs/reference/oauth/get-well-known-oauth-protected-resource-mcp) — MCP OAuth metadata path alias.

## Agent

- [`POST /v1/devices/{deviceId}/actions`](/docs/reference/agent/post-v1-devices-device-id-actions) — Request device action.
- [`POST /v1/broadcasts`](/docs/reference/agent/post-v1-broadcasts) — Request action on multiple devices.

## Owner and agent

- [`GET /v1/devices`](/docs/reference/owner-and-agent/get-v1-devices) — List visible devices.
- [`GET /v1/actions/{actionId}`](/docs/reference/owner-and-agent/get-v1-actions-action-id) — Get action state.
- [`POST /v1/actions/{actionId}/cancel`](/docs/reference/owner-and-agent/post-v1-actions-action-id-cancel) — Cancel queued action.
- [`GET /v1/functions`](/docs/reference/owner-and-agent/get-v1-functions) — List callable functions.

## Device

- [`POST /v1/device/{deviceId}/manifest`](/docs/reference/device/post-v1-device-device-id-manifest) — Publish device manifest.
- [`POST /v1/device/{deviceId}/next`](/docs/reference/device/post-v1-device-device-id-next) — Poll for next action.
- [`POST /v1/device/{deviceId}/result`](/docs/reference/device/post-v1-device-device-id-result) — Report action result.
- [`POST /v1/device/{deviceId}/events-ticket`](/docs/reference/device/post-v1-device-device-id-events-ticket) — Issue one-use WebSocket ticket.
- [`GET /v1/device/{deviceId}/events`](/docs/reference/device/get-v1-device-device-id-events) — Open device wake WebSocket.

## MCP

- [`POST /mcp`](/docs/reference/mcp/post-mcp) — Call authenticated MCP endpoint.