Skip to main content
The bundles endpoint lets you trigger an immediate re-scan and reload of a registered job bundle without restarting the MirrorNeuron node. This is useful when you have updated a bundle’s manifest or payloads and want the runtime to pick up the changes.

​
Reload a bundle

POST /api/v1/bundles/:bundle_id/reload
Forces MirrorNeuron to re-scan the bundle directory, compute a new fingerprint, and update the in-memory bundle registration if anything has changed. The response tells you whether the bundle actually changed and provides both the previous and current fingerprints for auditing.
This endpoint only applies to bundles that are already registered with the runtime. If the bundle ID is not found, you receive a 404 response.
Reloading a bundle does not affect jobs that are already running. Only jobs submitted after the reload will use the updated bundle.

​
Path parameters

​
bundle_id
string
required
The registered identifier of the bundle to reload, e.g. "prime_sweep_40_workers".

​
When to use this

Use the reload endpoint when you:
  • Update a payload script or configuration file inside a bundle directory
  • Make a non-breaking change to a bundle’s manifest.json
  • Need to invalidate a cached bundle fingerprint after a deployment

​
Example request

curl -X POST http://localhost:4000/api/v1/bundles/prime_sweep_40_workers/reload

​
Response

200 OK
​
bundle_id
string
required
The ID of the bundle that was reloaded.
​
changed
boolean
required
true if the bundle contents differ from the previously registered version.
​
reloaded
boolean
required
true if the bundle was successfully reloaded into memory.
​
previous_fingerprint
string
required
The content fingerprint of the bundle before this reload.
​
current_fingerprint
string
required
The content fingerprint of the bundle after this reload.
​
reason
string
required
The trigger reason for this reload. Always "api_request" when called via this endpoint.
​
message
string
required
A human-readable status message.
​
timestamp
string
required
ISO 8601 timestamp of when the reload completed.
{
  "bundle_id": "prime_sweep_40_workers",
  "changed": true,
  "reloaded": true,
  "previous_fingerprint": "a1b2c3d4...",
  "current_fingerprint": "e5f6g7h8...",
  "reason": "api_request",
  "message": "Bundle reloaded successfully",
  "timestamp": "2026-03-28T11:00:00.000Z"
}
404 Not Found — returned when no bundle with the given ID is registered. 
{
  "error": "Bundle prime_sweep_40_workers not found"
}
500 Internal Server Error — returned if the reload operation fails. 
{
  "error": "..."
}