Attention Items
List attention items
List the conversations Dex flagged as waiting on the user — a reply someone expects, or an action such as signing or renewing — newest first. Open items only unless `includeResolved=true`. Cursor-pagi
GET /v2/attention-items/
Parameters
Query parameters
take
integer
cursor
string (uuid)
includeResolved
boolean
Responses
200 — Successful response
Content-Type: application/json
data
object required
data.attentionItems
array<object> required
data.attentionItems[].id
string (uuid) required
data.attentionItems[].user_id
string
data.attentionItems[].contact_id
string (uuid) | null
data.attentionItems[].source
string
data.attentionItems[].source_provider_id
string
data.attentionItems[].title
string
data.attentionItems[].body
string | null
data.attentionItems[].item_link
string | null
data.attentionItems[].sender_name
string | null
data.attentionItems[].sender_email
string | null
data.attentionItems[].resolved_at
string (date-time)
data.attentionItems[].created_at
string (date-time)
data.attentionItems[].updated_at
string (date-time)
data.attentionItems[].next_cursor
string
data.attentionItems[].contacts
object | null
data.pagination
object
data.pagination.nextCursor
string | null
data.pagination.count
integer
Example
{
"data": {
"attentionItems": [
{
"id": "00000000-0000-0000-0000-000000000000"
}
]
}
}
400 — Request body failed validation.
Content-Type: application/json
(body)
any
401 — Missing or invalid API key.
Content-Type: application/json
(body)
any
403 — Valid key, insufficient permission.
Content-Type: application/json
(body)
any
404 — Resource does not exist.
Content-Type: application/json
(body)
any
409 — Request conflicts with the current state of the resource.
Content-Type: application/json
(body)
any
429 — Rate limit exceeded.
Content-Type: application/json
(body)
any
500 — Unexpected server error.
Content-Type: application/json
(body)
any
Code samples
curl https://api.prod.getdex.com/v2/attention-items/ \
--header 'Authorization: Bearer YOUR_API_KEY'
fetch('https://api.prod.getdex.com/v2/attention-items/', {
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
})
requests.get(
"https://api.prod.getdex.com/v2/attention-items/",
headers={
"Authorization": "Bearer YOUR_API_KEY"
}
)
List workspace calendar events
One window of the workspace calendar, `start` to `end` (ISO 8601 with offset, at most 7 days apart, plus an hour for a week that crosses a DST change; the start's offset decides which days teammates'
Draft a reply to an attention item
Draft the user's reply to the item's thread in their saved drafting style. Nothing is sent and the draft is not saved; a thread that had to be read live is saved onto the item unless `?save_thread=fal

