---
title: "POST /v1/workflows/{id}/widget"
method: POST
path: "/v1/workflows/{id}/widget"
---

# POST /v1/workflows/{id}/widget

`POST /v1/workflows/{id}/widget`

Enable public widget for a workflow

## Path parameters

- `id` string, required

## Request body

- union
  - object
  - PublishWidgetParams
    - `buttonLabel` string — ButtonLabel is the text displayed on the trigger button (optional, defaults to "Send")
    - `description` string — Description explains what the workflow does (optional)
    - `maxAmount` string — MaxAmount is the maximum amount allowed per trigger (optional)
    - `minAmount` string — MinAmount is the minimum amount required to trigger (optional)
    - `title` string, required — Title is the display title for the widget (required)

## Response `200`

OK

- PublishWidgetSuccessResponse
  - `code` integer
  - `data` PublicWidgetData — Widget contains the public widget configuration with derived trigger values
    - `buttonLabel` string — ButtonLabel is the text displayed on the trigger button
    - `chainId` integer — ChainID is derived from the trigger's chainId
    - `description` string — Description explains what the workflow does
    - `enabled` boolean — Enabled controls whether the public widget is active
    - `maxAmount` string — MaxAmount is the maximum amount allowed per trigger (in smallest unit)
    - `minAmount` string — MinAmount is the minimum amount required to trigger (in smallest unit)
    - `recipientAddress` string — RecipientAddress is derived from the trigger's toAddress/contractAddress
    - `title` string — Title is the display title for the widget
    - `tokenAddress` string — TokenAddress is derived from the trigger's tokenAddress (empty for native token)
  - `message` string
  - `requestId` string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/b3-fun/apis/b3os-workflow-api.md) · [All operations](https://skmtc.net/b3-fun/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b3-fun/b3os-workflow-api/revisions/5a750a5a9596/schema)