Charts

Move chart to another board

Moves the chart to a different board in the same project. The target board must differ from the current one.

put/v0/boards/{boardId}/charts/{chartId}/move

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/boards/{boardId}/charts/{chartId}/move
  • Auth: HTTP bearer

Path parameters

boardIdstring required
chartIdstring required

Headers

Idempotency-Keystring

Optional unique value (e.g. a UUID v4) that lets you safely retry POST/PUT/PATCH/DELETE requests. The first request runs normally; subsequent requests with the same key replay the stored response (status + body) for 24 hours, so retries can never double-create or double-charge. Two concurrent requests with the same key return 409 IDEMPOTENCY_IN_PROGRESS. Generate a fresh key per logical operation.

Request body

targetBoardIdstring required

The board to move the chart to.

Response

The moved chart

idstring required
chart_type'table' | 'number' | 'funnel' | 'bar' | 'line' | 'area' | 'pie' | 'stacked' | 'user_paths' | 'retention' required

Visualization type.

titlestring required
descriptionstring nullable
querystring required

SQL query powering the chart. For funnel and retention charts this is a system-managed placeholder.

project_idstring required
board_idstring required
x_axisstring nullable

Column used as the X axis.

y_axisstring[] nullable

Column(s) used as Y axis metric(s).

group_bystring nullable

Column used to group/stack series.

Changes

No recorded changes to this operation across all 1 revision of this API.