All systems normalDashboardGet an API key
API reference / Connected sessions / Session background flush

Session background flush

Flush stay_out and terminate AppLog telemetry when backgrounding a session.

POSTapi.tikultra.com/v1/account/session/background10 credits
Upstream
/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.

stay_duration_msinteger

Foreground session duration in milliseconds. For example 94200.

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.

stay_duration_msinteger

Stay duration in milliseconds.

applog_events_flushedstring[]

Decoded applog events flushed value.

batch_http_statusinteger

Decoded batch http status value.

took_msinteger

Gateway execution or signing latency in milliseconds.

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.