v1.5: New /snapshots route

[guimachiavelli]

v1.5 introduces a new API route, /snapshots. This route works similarly to /dumps and generates snapshots on demand:

curl \
  -X POST 'http://localhost:7700/snapshots'

Tasks

• Create new page /reference/api/snapshots.mdx
• Update /learn/advanced/snapshots.mdx with mentions/examples of the new route
• Update telemetry table /learn/what_is_meilisearch/telemetry.mdx
• Update /reference/api/keys.mdx with new action

References

• PRD (private link): https://www.notion.so/meilisearch/On-demand-snapshots-5676e542b905459d96eec228da133b00#847ff0cafeb64fe09e8ee7150852b474
• spec: Snapshot creation on demand specifications#258
• issue on engine repo: Create snapshots on demand meilisearch#4052
• SME: @irevoire

[guimachiavelli]

@irevoire: dump creation tasks have precedence over other tasks and get bumped to the top of the queue. Does the same happen with snapshot creation tasks?

[curquiza]

Hello @guimachiavelli
I asked your question directly to the dedicated public page about usage in the PRD to avoid losing information about usage (your question is definitely a good one!) 😊

[irevoire]

Hey @guimachiavelli, yes, the task priorities are specified here: https://specs.meilisearch.com/specifications/text/0060-tasks-api.html#_2-technical-details

1. taskCancelation
2. taskDeletion
3. snapshotCreation
4. dumpCreation
5. All other task types with by their enqueued at order.

[guimachiavelli]

Apologies, I somehow missed that when I was reading the spec earlier 🙇

[irevoire]

No problem, https://specs.meilisearch.com/ works pretty well if you don't know where to search in the spec (which is always my case).