Create a dashboard

Create an analytics dashboard. Only spec is required. Creating a dashboard does not share it; the share link is made from the app.

Viewer settings

settings controls what viewers of the dashboard's share link see on each media page. Each section (fields, feedback, labels, comments) is saved on its own: the section you send replaces the stored one in full, and a section you leave out keeps its stored value. Read the dashboard first and resend every key of the section you change.

Labels and comments are off until you turn them on. With labels.mode set to apply or comments.mode set to reply, a viewer picks one of the dashboard's feedback submitter names (feedback.submitters, even while feedback itself is off), or types another name when feedback.allowOtherSubmitter is on, and writes under that name. With no names and other names off, nobody can write. The link has no sign-in, so these writes are not authenticated: the link holder chooses the name and Speak AI records the entry under it without checking who sent it, the same as feedback. Only the dashboard's feedback names are accepted, plus any other name when feedback.allowOtherSubmitter is on. Speak AI accepts this risk by design and limits it: every entry written through the link is shown as made via the dashboard, a name can change or delete only the entries written under it from that dashboard, a name that is not allowed is refused on every write, and revoking the link stops every write at once. List only the names you are happy for link holders to write as.

Errors

• 400 when a field fails validation, the spec is invalid, the payload is too large, or a label group is not an active group of your company ("Choose active label groups from this workspace."). Nothing is saved.