All systems normalDashboardGet an API key
API reference / Connected sessions / Send image

Send image

Send an image.

POSTapi.tikultra.com/v1/account/dm/send-image35 credits
Upstream
/im/v1/message/send
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.

conversation_idstringrequired

The conversation. For example 0:1:6970000000000000001:6970000000000000002.

image_urlstringrequired

The image. For example https://cdn.acme.dev/media/keycaps.jpg.

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.

message_idstring

Server-assigned IM message Snowflake ID.

conversation_idstring

Full mobile IM conversation identifier.

conversation_short_idstring

Numeric 64-bit short conversation ID used by IM wire calls.

msg_typeinteger

Decoded msg type value.

typestring

Decoded type value.

mediaobject

Structured media metadata.

media.uristring

Decoded uri value.

media.widthinteger

Decoded width value.

media.heightinteger

Decoded height value.

statusstring

Current lifecycle or health status.

create_timeinteger

Unix timestamp (seconds) when the item was created.

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.