Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Bubble Plugin Context API
description: 'The Bubble Plugin API is a JavaScript SDK surface (not an HTTP API) that plugin
authors use to extend Bubble apps. It exposes server-side actions, client-side
actions, and visual elements that read configured properties and interact with
the runtime via a `context` object. Plugin API v4 replaces Fibers with
Promises and adds first-class type checks (`isBubbleThing`, `isBubbleList`),
by-id lookups (`getThingById`, `getThingsById`), and async iteration on
`BubbleList`.
This OpenAPI document describes the SDK surface as a virtual REST API for
catalog and discovery purposes. Each "endpoint" represents a callable
JavaScript function in the plugin runtime; `paths` carry the function name
and `requestBody`/`responses` describe its parameters and return value.
'
version: '4.0'
contact:
name: Bubble Support
url: https://bubble.io/contact
license:
name: Bubble Plugin Marketplace Terms
url: https://bubble.io/legal/plugins
servers:
- url: virtual://plugin-runtime
description: 'Virtual server. Plugin actions and elements execute inside the Bubble
runtime; there is no public HTTP endpoint.
'
tags:
- name: Context
description: Helpers exposed on the runtime context object.
paths:
/context/async:
post:
tags:
- Context
summary: Run Async Block
description: 'Wrap an asynchronous operation. In v4 this is `context.v3.async()`
and is deprecated in favor of native `async/await`.
'
operationId: contextAsync
responses:
'200':
description: Async block completed.
/context/request:
post:
tags:
- Context
summary: Make HTTP Request
description: 'Issue an outbound HTTP request from a server-side action. In v4
this is `context.v3.request()` and is deprecated in favor of any
npm-installed HTTP client.
'
operationId: contextRequest
responses:
'200':
description: HTTP response.