Skip to content
IForevents Docs
IForevents Docs
HomeDashboardGitHubPrivacyTermsSecurityIntroduction
Support and SLA

Create a board (any role but viewer)

POST
/v1/boards

Authorization

bearerAuth
AuthorizationBearer <token>

Session token issued by the accounts service (or the legacy /v1/auth routes).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/boards" \  -H "Content-Type: application/json" \  -d '{    "definition": {      "filters": [],      "match": "all",      "range": "7d",      "widgets": [        {          "breakdown": {            "property": "plan",            "scope": "event"          },          "id": "w1",          "interval": "day",          "kind": "line",          "metric": "total",          "series": [            {              "event": "signup",              "filters": [                {                  "operator": "eq",                  "property": "plan",                  "scope": "event",                  "values": [                    "pro",                    "growth"                  ]                }              ],              "label": "Signups",              "match": "all"            }          ],          "size": "md",          "title": "Signups"        }      ]    },    "description": "Weekly growth metrics",    "name": "Growth"  }'
{  "board": {    "created_at": "2026-09-13T12:30:45Z",    "created_by": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",    "definition": {      "filters": [],      "match": "all",      "range": "7d",      "widgets": [        {          "breakdown": {            "property": "plan",            "scope": "event"          },          "id": "w1",          "interval": "day",          "kind": "line",          "metric": "total",          "series": [            {              "event": "signup",              "filters": [                {                  "operator": "eq",                  "property": "plan",                  "scope": "event",                  "values": [                    "pro",                    "growth"                  ]                }              ],              "label": "Signups",              "match": "all"            }          ],          "size": "md",          "title": "Signups"        }      ]    },    "description": "Weekly growth metrics",    "name": "Growth",    "project_uuid": "5f1c2e7a-1c2d-4b3e-9f10-1a2b3c4d5e6f",    "updated_at": "2026-09-13T12:30:45Z",    "uuid": "1b2c3d4e-5f60-4a1b-8c2d-3e4f5a6b7c8d",    "version": 3,    "visibility": "project",    "widget_count": 1  }}
definition?
description?string
name*string
visibility?string