Skip to main content
GET
List CRM field updates Tempo generated for visible organization deals

Authorizations

Authorization
string
header
required

Your organization API key. Paste the key itself — the "Bearer " prefix is added for you.

Headers

X-Acting-User
string

Run the request as this organization member (user id or email). Omit to run as the organization. A value that is not a member returns 403.

Query Parameters

deal_id
string<uuid>

Restrict to one opportunity. With deal_id the cross-deal defaults (open, non-renewal, last 30 days) do not apply.

status
enum<string>

Omit for pending proposals; approved returns updates already written to the CRM.

Available options:
pending,
approved,
rejected
since
string

Only updates changed on or after this date or date-time.

update_ids
string[]

Exact update ids, comma-separated or repeated.

field_ids
string[]

Exact field ids, comma-separated or repeated.

deal_state
enum<string>

Cross-deal lists default to open.

Available options:
open,
closed,
all
deal_types
string[]

CRM opportunity types, comma-separated or repeated.

exclude_renewals
boolean

Cross-deal lists default to true.

stages
string[]

CRM stage names, comma-separated or repeated.

max_days_since_update
integer

Only deals updated within this many days. Cross-deal lists default to 30.

Required range: x >= 0
key_fields_only
boolean

Only updates on fields marked as key fields.

suppress_no_op
boolean

Hide proposals whose value equals the current CRM value. Defaults to true.

truncate
boolean

Truncate long values and cited observations. Defaults to true.

limit
integer
default:25

Rows per page.

Required range: 1 <= x <= 100
offset
integer

Row offset; use next_offset from the previous page.

Required range: x >= 0

Response

Deal updates returned.

deal_id
string | null
required

The deal_id filter, or null for a cross-deal list.

review_url
string | null
required

Link to the deal's Updates tab in the Tempo app; null for a cross-deal list.

summary
object
required
page_total
integer
required

Rows on this page.

matching_total
integer
required

Rows matching the filters across all pages.

deal_total
integer
required

Distinct deals on this page.

updates
object[]
required
observations
object
required

Cited observations keyed by observation_id.

artifacts
object
required

Cited artifacts keyed by artifact_id.

filters_applied
string[]
required

Names of the default and explicit filters that shaped the result.

next_offset
integer | null
required

Pass as offset for the next page; null on the last page.