TSHTTPTXNSERVERPUSH(3ts)

💅 TSHTTPTXNSERVERPUSH — 3ts

okay bestie, welcome to the Apache Traffic Server corner of the manual, section 3ts, where we talk about TSHttpTxnServerPush 🫶 pull up a chair, this one's short and sweet.

---

✨ NAME ✨

TSHttpTxnServerPush — it's the TSHttpTxnServerPush API function, no notes, that's the whole name, slay.

---

🌸 SYNOPSIS 🌸

#include <ts/ts.h>

TSReturnCode TSHttpTxnServerPush(TSHttpTxn txnp, const char *url, int
url_len)

like… look at her. iconic signature. 👑

---

🦋 DESCRIPTION 🦋

So the vibe here is: you're pushing content to a client using the Server Push mechanism. that's it, that's the job. ✨

Now, important, don't skip this part: this API only works if the protocol of a transaction supports Server Push and it's not disabled by the client. but here's the good news — you can literally just call this API without checking whether Server Push is even available on the transaction, because if it's not available, this function does nothing. no crash, no drama, just silence. she's low maintenance like that. 💅

But when does she actually throw hands? This API returns an error if:

• the URL to push is not valid 🙈
• the client has Server Push disabled 💀
• there's an error creating the H/2 PUSH_PROMISE frame 😭

so yeah, three ways to get an error back, keep those in your notes bestie.

---

👑 SEE ALSO 👑

• TSAPI(3ts)

that's the whole friend group for this one, go read it, iykyk.

---

🎀 COPYRIGHT 🎀

2026, dev@trafficserver.apache.org

---

and that's the page fr fr 🌈 huge thanks to the Apache Traffic Server crew — this doc is from version 9.2, dated Feb 12, 2026, and the copyright belongs to 2026, dev@trafficserver.apache.org. mwah, bye bestie, go push some content 🫶✨💖