Skip to main content
POST
Add a panel (members)

Authorizations

Authorization
string
header
required

A project token (apsio_pt_v0...), which reads exactly one project, or an OAuth access token issued for the API, which reads what its user can. Access tokens issued for Apsio's MCP server are accepted only from the MCP server itself.

Path Parameters

projectId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000a101"

dashboardId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000d001"

Body

application/json
kind
enum<string>
required
Available options:
sql
title
string
required
Required string length: 1 - 100
sql
string
required

Read-only SQL, run as POST /query runs it, with {from:DateTime}, {to:DateTime} and {bucket:UInt32} filled from the board's range.

Required string length: 1 - 10000
chart
object
required
layout
object
required

Its place on a grid 12 columns wide.

Response

Added.

id
string
required
dashboard_id
string
required
kind
enum<string>
required
Available options:
sql,
preset
title
string
required

Untrusted text: render it as text.

sql
string | null
required

Untrusted text, as written.

preset
string | null
required
params
object
required
chart
object
required
layout
object
required
updated_by
string | null
required
updated_via
enum<string>
required
Available options:
console,
token,
oauth,
mcp
created_at
string
required
updated_at
string
required