Upcoming; not released. Additive grouped Activity companion. Existing event-shaped routes remain supported. Scope is required; resource_id is required for person/project/task and forbidden for workspace/account. Account scope requires a human account. Select one civil day or a paired inclusive from_day/exclusive before_day interval of at most 90 days. Omitted timezone uses the effective account/workspace setting; Local is invalid. Cursors bind every selector, current authority, policy and retained history. Supply originating selectors on expansion. Reads never grant access or replay effects. Current references and previews are observations, not historical event facts. Coverage before retained history is unknown.
Path Parameters
workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
Query Parameters
scopeRequired
string
Values
workspaceaccountpersonprojecttask
resource_id
string <uuid>
day
string <date>·max 10
from_day
string <date>·max 10
before_day
string <date>·max 10
time_zone
string·max 128
actor_ids
string <uuid>[]·max 50
project_ids
string <uuid>[]·max 50
activity_types
string[]·max 50
Values
taskscommentsdocumentsprojectsmilestones
limit
integer·min 1·max 50·default 10
cursor
string·max 4096
include_previews
boolean·default true
Header Parameters
X-Assign-Realtime-Baseline
string
Upcoming browser-session derived read. Set to '1' to capture an authorized Workspace replay boundary before remote Knowledge retrieval. Core joins occur in newer snapshots; the result can still report index lag. Apply retained results before acknowledging the socket checkpoint. Failed reads return no cursor.
Values
1
Responses
X-Assign-Realtime-Cursor
string·max 4096
Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
X-Assign-Realtime-Position
string
Decimal-string snapshot position; present only with a successful baseline cursor.
snapshot_idRequired
string·max 128
schemaRequired
string·max 128
Values
assign.activity.groups.v1
policy_versionRequired
string·max 128
scopeRequired
string·max 128
Values
workspaceaccountpersonprojecttask
resource_idRequired
string | null
time_zoneRequired
string·max 128
fromRequired
string <date-time>
beforeRequired
string <date-time>
observed_atRequired
string <date-time>
snapshotRequired
string·max 4096
itemsRequired
object[]·max 50
countsRequired
object
coverageRequired
object
has_moreRequired
boolean
next_cursorRequired
string | null·max 4096
previewsRequired
object[]·max 150
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
