> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dalyenergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh Shading Scene

> Re-run shading calculation for an existing scene

# POST /shadingscenes/{scene_id}/refresh

Clear existing shading results and queue a fresh shading computation for the specified scene. Use this when results are stale, a previous run failed, or tracking parameters have been updated.

## Notes

* This endpoint clears any cached shading results before queuing the new computation.
* The shading simulation runs asynchronously. Poll [GET /shadingscenes/{scene_id}/results](/api-reference/endpoints/shading-scenes-results) to track progress.
* Returns task context on success, similar to the create endpoint response.
* Returns `404` if the scene does not exist.
* Returns `503` if the computation could not be queued (e.g., worker infrastructure unavailable).
* Requires write-level workspace access.
* Refreshing a scene that already has a running computation will replace the in-progress task.