# Sync specific outbound notefiles

**URL:** <https://discuss.blues.com/t/sync-specific-outbound-notefiles/3421>\
**Category:** Uncategorized\
**Created:** [January 9, 2026, 1:24pm UTC](https://discuss.blues.com/t/sync-specific-outbound-notefiles/3421 "2026-01-09T13:24:03Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jakov](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.blues.com/jakov/32/1714_2.png) [@Jakov](https://discuss.blues.com/u/Jakov)\
**Post date:** [January 9, 2026, 1:24pm UTC](https://discuss.blues.com/t/sync-specific-outbound-notefiles/3421/1 "2026-01-09T13:24:03Z")

</div>

Going through online docs [`note.add`](https://dev.blues.io/api-reference/notecard-api/note-requests/latest/#note-add), there is a note on sync option

 ![image](https://us1.discourse-cdn.com/flex020/uploads/blues/original/2X/0/0cd0b2435667c01a3ce211d06ee01a460d322e97.jpeg)

Tested this a bit manually with a DB and Outbound Queue notefiles, where I’d set `"sync": true` to one of the notes on the outbound queue. But the DB file would also get synced.  
Is this the intended behavior? Are the guarantees only applying across the outbound queue notefiles?

Observing the `file.changes.pending` and trace logs, it appears that it syncs all of them, as soon after I submit a single note with `"sync": true` option on an outbound queue.

> **trace: sched,event,comm,sync,file,mem,checkpoint**
>
> The `sensorevents.qos` is the outbound queue notefile that I was looking to sync exclusively:
> 
> ```auto
> S82:15.81 sync: work to be done:
> S82:15.82 upload-notebox
> S82:15.82 upload _env.dbs
> S82:15.82 upload _health.qo
> S82:15.83 
> S82:15.83 upload _log.qo
> S82:15.83 upload _track.qo
> S82:15.84 upload deviceconfig.dbs
> S82:15.84 upload deviceevents.qos
> S82:15.85 upload devicestatus.qos
> S82:15.86 upload outputconfig.dbs
> S82:15.86 upload sensorconfig.dbs
> S82:15.87 upload sensorevents.qos
> S82:15.88 download _env.dbs
> S82:15.88 download deviceconfig.dbs
> S82:15.88 download sensorconfig.dbs
> 
> ```

---

<div class="post-metadata">

**Author:** ![Jakov](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.blues.com/jakov/32/1714_2.png) [@Jakov](https://discuss.blues.com/u/Jakov)\
**Post date:** [January 9, 2026, 1:29pm UTC](https://discuss.blues.com/t/sync-specific-outbound-notefiles/3421/3 "2026-01-09T13:29:01Z")

</div>

Looking through related posts, I came across [this](https://discuss.blues.com/t/outbound-queue-not-transmitted-when-syncing/543/7):

> [@Outbound queue not transmitted when syncing](https://discuss.blues.com/t/outbound-queue-not-transmitted-when-syncing/543/7):
>
> Hey @Alec, Just checked with the team here. As @RobLauer mentioned, setting sync: true on a note.add request only guarantees a sync of that individual file. In most conditions syncing one note will also sync all other queued notes, but it’s not guaranteed. For example the Notecard could temporarily lose connection to Notehub. I’m guessing that’s why your notes almost always sync at the same time, but occasionally have a bit of a time difference. I’d try hub.sync and see if that fixes the disc…

So it’s not a guarantee? I just want to confirm so that I know which pieces of Notecard sync API are of a non-functional sort and not intended to provide a definable syncing behavior checkpoints.

---

<div class="post-metadata">

**Author:** ![tjvantoll](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.blues.com/tjvantoll/32/231_2.png) [@tjvantoll](https://discuss.blues.com/u/tjvantoll)\
**Post date:** [January 9, 2026, 6:35pm UTC](https://discuss.blues.com/t/sync-specific-outbound-notefiles/3421/4 "2026-01-09T18:35:30Z")

</div>

Hey @Jakov ,

What I said in that previous thread is still accurate: in practice the `sync` flag on `note.add` is going to sync all outbound Notefile changes, but there are some edge cases where that might not be the case.

If you need to sync all outbound changes we encourage users to use the `hub.sync` request, and you can use the `out` flag if you only want to sync outbound changes `{"req":"hub.sync","out":true}`.

TJ