Create Dashboard Module

post

https://api.sev.co/v1/dashboard/{scope}/module/{id}

Create a dashboard module in a group. The module ID is taken from the path and must be a new UUID generated by the client. The request body must include groupLastUpdated, set to the parent group's current audit.last_updated value — a mismatch returns 409 (the group was modified concurrently). Creating a module also updates the parent group's module layout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

scope

string

enum

required

Dashboard visibility scope: org for organization-wide dashboards, org_user for the calling user's personal dashboards.

Allowed:

uuid

required

Dashboard module ID (UUID, supplied by the client on create)

Body Params

uuid

required

groupId

uuid

required

label

string

required

version

string

required

order

integer

required

gridX

integer | null

gridY

integer | null

gridHeight

integer

required

gridWidth

integer

required

type

string

enum

required

Allowed:

entityType

string

required

aggregationMode

string | null

enum

Allowed:

groupingField

string

required

savedQuery

object

Reference to a saved search powering a module

timeBucket

string

required

xAxisField

string

required

start

string | null

end

string | null

groupLastUpdated

date-time

required

The parent group's current audit.last_updated value, used for optimistic concurrency

Headers

x-sevco-target-org

string

Sevco Organization ID

Responses

400

Invalid request body or missing groupId/groupLastUpdated

404

Group not found

409

The group was modified since groupLastUpdated; re-fetch the group and retry

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Module created