All systems normalDashboardGet an API key
API reference / Connected sessions / Session heartbeat tick

Session heartbeat tick

Execute periodic in-session SceneAutoReport and AppLog heartbeat tick.

POSTapi.tikultra.com/v1/account/session/tick10 credits
Upstream
/ri/report/service/2/app_log/
Access
Growth and up
Runs on
FullPool
Billing
Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

lifecyclestring

Decoded lifecycle value.

device_idstring

Provisioned mobile device identifier.

mssdk_scenesstring[]

Decoded mssdk scenes value.

applog_heartbeatstring

Decoded applog heartbeat value.

sdk_counterinteger

Decoded sdk counter value.

next_tick_recommended_secinteger

Unix timestamp (seconds) for next tick recommended.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.