Skip to main content
POST
/
api
/
v1
/
context
/
items
/
lookup
curl --request POST \
  --url https://api.staging.getmodus.com/api/v1/context/items/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contextType": "slack_workspace_channel_list",
  "dataPath": [
    "00000000-0000-4000-a000-000000000111",
    "T0123456"
  ],
  "contentProjection": {
    "fields": [
      "isPartial"
    ],
    "arrays": {
      "channels": [
        "channelId",
        "channelName",
        "isPrivate"
      ]
    }
  }
}
'
{
  "item": {
    "uid": "<string>",
    "contextType": "<string>",
    "dataPath": [
      "<string>"
    ],
    "content": {},
    "connectionId": "<string>",
    "selectionId": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contextType
string
required

Context type of the row to fetch (e.g. slack_workspace_channel_list).

Example:

"slack_workspace_channel_list"

dataPath
string[]
required

Hierarchical data path identifying the row. Full equality match against the row's data_path column.

Example:
[
"00000000-0000-4000-a000-000000000111",
"T0123456"
]
contentProjection
object

Optional JSONB projection applied at SQL time to shrink the payload. When omitted the full content column is returned.

Response

item
object
required

The matched row, or null when no row in the caller's tenant matches the supplied (contextType, dataPath).