Skip to main content
GET
/
api
/
v1
/
context
/
items
/
{uid}
Fetch a single context item by uid
curl --request GET \
  --url https://api.staging.getmodus.com/api/v1/context/items/{uid} \
  --header 'Authorization: Bearer <token>'
{
  "uid": "7a3f9d2c-1111-4000-a000-000000000abc",
  "orgId": "00000000-0000-0000-0000-000000000001",
  "contextType": "note",
  "content": {},
  "userFeedback": "neutral",
  "topics": [
    "analytics",
    "q3"
  ],
  "dataPath": [
    "salesforce",
    "00000000-0000-4000-a000-000000000111",
    "Account",
    "Name"
  ],
  "createdAt": "2026-05-01T10:00:00.000Z",
  "updatedAt": "2026-05-11T10:00:00.000Z",
  "description": "Q3 churn analysis notes",
  "connectionId": "00000000-0000-4000-a000-000000000111",
  "selectionId": "00000000-0000-4000-a000-000000000222",
  "lastUpdateMetadata": {
    "action": "auto_analysis",
    "timestamp": "2026-05-11T10:00:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth 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:
["analytics", "q3"]
​
dataPath
string[]
required

Hierarchical Postgres text[] path that places the item inside the datamap (used for filtering by data asset).

Example:
[
  "salesforce",
  "00000000-0000-4000-a000-000000000111",
  "Account",
  "Name"
]
​
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

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:
{
  "action": "auto_analysis",
  "timestamp": "2026-05-11T10:00:00.000Z"
}