Skip to main content
POST
Send Media

Authorizations

Authorization
string
header
required

Your OmniX API key, e.g. omnix_live_.... Billed per call.

Body

application/json
auth_token
string
required

The X account auth_token cookie the action runs as.

Example:

"YOUR_X_AUTH_TOKEN"

encryption_code
string
required

Your XChat encryption code — the PIN you set when enabling encrypted chats on X. Used to recover your key so messages can be decrypted and outgoing events signed.

Example:

"YOUR_XCHAT_PIN"

conversation_id
string
required
Example:

"1000000000000000001:2000000000000000002"

image_url
string

A URL to fetch the media from. Provide this or image_base64.

image_base64
string

Base64 of the file (with or without a data: prefix). Provide this or image_url.

text
string

Optional caption.

type
integer
default:1

1=image (default), 2=gif, 3=video, 4=audio, 5=file, 6=svg.

filename
string
width
integer
height
integer
proxy
string

Optional outbound proxy for this call (http:// or https://, optionally user:pass@host:port). The X request runs through it — useful for geo-routing or spreading calls across IPs. SOCKS proxies are not supported.

Example:

"http://user:pass@host:8080"

Response

Media sent.

status
boolean
Example:

true

data
object
error
string | null
Example:

null