DataClipState

Type: Object

A saved MicroSQL reporting query that can be re-run in-app or exported publicly as JSON/CSV/NDJSON via its share token. Scoped to a single tenant.

Fields

Name	Type	Args	Description	Deprecated
createdAt	String!		ISO-8601 timestamp of when the clip was first saved.
creatorId	UserID!		TypeID of the user who created the clip (e.g. "usr_01K…"). Not reassigned on update.
csvExportPath	String!		Relative path for CSV export (combine with server base URL)
description	String		Optional free-text note explaining what the clip reports; null when unset. At most 1000 characters.
id	DataClipID!		TypeID of this data clip (e.g. "dcl_01K…").
jsonExportPath	String!		Relative path for JSON export (combine with server base URL)
name	String!		Human-readable label for the clip, shown in listings. Required and non-empty.
queryString	String!		The saved MicroSQL query the clip runs. Executed against the tenant's reporting schema with tenant isolation injected at execution time.
shareToken	String!		Secret 64-hex-character (256-bit) token that grants unauthenticated access to this clip's export endpoints. Anyone holding it can read the clip's results, so treat it as a credential; rollDataClipShareToken replaces it and invalidates old links.
updatedAt	String!		ISO-8601 timestamp of the clip's last change, including a share-token roll.