Skip to main content
GET
Get a context item

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

uid
string
required

UUID of the context item.

Example:

"7a3f9d2c-1111-4000-a000-000000000abc"

Response

uid
string
required

Stable UUID for the context item. Use this on PATCH / DELETE / values endpoints.

Example:

"7a3f9d2c-1111-4000-a000-000000000abc"

orgId
string
required

Org UUID this item belongs to. Matches the caller’s principal.

Example:

"00000000-0000-0000-0000-000000000001"

contextType
string
required

Per-row context type identifier — one of note, link, saved_query, plus the dozens of integration-driven types (e.g. looker_dashboard_metadata, salesforce_object_field).

Example:

"note"

content
object
required

Type-specific JSON content. Shape varies by contextType; treat as opaque unless you know the kind.

userFeedback
enum<string>
required

User-supplied verification verdict. positive ≈ approved/verified; negative ≈ rejected/dismissed; neutral is the default.

Available options:
negative,
neutral,
positive
Example:

"neutral"

topics
string[]
required

Free-form topic tags. Used for sidebar filtering on the SPA.

Example:
dataPath
string[]
required

Hierarchical path that places the item inside the data map (used for filtering by data asset).

Example:
createdAt
string
required

Creation timestamp.

Example:

"2026-05-01T10:00:00.000Z"

updatedAt
string
required

Most recent update timestamp.

Example:

"2026-05-11T10:00:00.000Z"

description
string | null

Human-readable description (separate from the type-specific content blob).

Example:

"Q3 churn analysis notes"

connectionId
string | null

Originating integration connection id for integration-derived items. Null for user-created items.

Example:

"00000000-0000-4000-a000-000000000111"

selectionId
string | null

Originating selection id (datamap-scoped) for integration-derived items.

Example:

"00000000-0000-4000-a000-000000000222"

lastUpdateMetadata
object | null

Audit blob recording who/what last edited the item (action, user_id/editedByName/editedByEmail, timestamp). Used by the SPA to render the "Last Update" column.

Example: