MONGOC_CHANGE...T_RESUME_TOKEN(3)

💅 MONGOC_CHANGE...T_RESUME_TOKEN(3) 💅

okay so bestie, welcome to libmongoc — this is the page for mongoc_change_stream_get_resume_token, and honestly? it's a little guy with one job and it slays at it. 🎀

---

✨ SYNOPSIS ✨

const bson_t *
mongoc_change_stream_get_resume_token (mongoc_change_stream_t *stream);

This function returns the cached resume token 🫶 — and like, the whole point is that you can pass that token as <highlight>either</highlight> the resumeAfter or the startAfter option of a watch function, and boom, you get a brand new change stream starting from the exact same point. no cap, that's the entire vibe. ✨

---

🌸 PARAMETERS 🌸

• stream — a mongoc_change_stream_t. that's it. that's the whole parameter list. she's low maintenance. 💅

---

🦋 RETURNS 🦋

A bson_t that should not be modified or freed — like, hands off, bestie, it's not yours to mess with. 🙈

It returns NULL if there's no resume token available. and when does that happen? it's possible if the change stream hasn't been iterated yet <highlight>and</highlight> neither the resumeAfter nor the startAfter options were specified in the watch function. so basically: no iteration, no options, no token. 💀

---

🧚 LIFECYCLE 🧚

The returned bson_t is valid for the lifetime of stream — and heads up, its data may get updated if mongoc_change_stream_next() is called after this function. 👀 so if you're not trying to have the rug pulled out from under you, you can copy the value to extend its lifetime or to preserve the current resume token. protect your peace, protect your token. 🫶

---

👑 AUTHOR 👑

MongoDB, Inc

💜 COPYRIGHT 💜

2009-present, MongoDB, Inc.

---

and that's the whole page, bestie — you ate that 💅✨

source/version: libmongoc 2.5.6 · dated Oct 09, 2026 · go forth and resume those streams 🦋