Skip to main content
POST
Update or end an owned test; production activities cannot be selected.
This endpoint requires push.test.send and the test’s explicitly selected project. Supply event: "update" or "end" and the permitted payload. The existing creator, app, and device remain pinned. End the authorized test when the workflow is complete.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>

Explicit project context. Required for personal-key project resource calls; integration keys retain their configured default. MCP clients supply project_id in each tool call instead.

Path Parameters

test_id
string<uuid>
required

Body

application/json
event
enum<string>
required

Test lifecycle event.

Available options:
update,
end
activity_type
string

Native activity type.

attributes_type
string

Native activity attributes type.

title
string

Activity title.

subtitle
string

Activity subtitle.

body
string

Activity message.

status
string

Application status.

progress
number
Required range: 0 <= x <= 1
eta
string

Application ETA.

image_url
string<uri>

Image URL.

accent_color
string

Accent color.

launch_url
string

Tap destination.

content_state
object
attributes
object
priority
enum<integer>
Available options:
5,
10
stale_at
string<date-time>

ISO 8601 stale time.

dismiss_at
string<date-time>

ISO 8601 dismiss time.

relevance_score
number
Required range: 0 <= x <= 1
sound
string

Native sound.

data
object
stale_date
string<date-time>

Legacy alias for stale_at.

dismissal_date
string<date-time>

Legacy alias for dismiss_at.

buttons
object[]

Native activity buttons.

Maximum array length: 3

Response

Successful response

data
object
required
status
integer
metadata
object
{key}