Skip to main content
POST
/
shadingscenes
/
{scene_id}
/
refresh
Refresh Shading Scene
curl --request POST \
  --url https://api.example.com/shadingscenes/{scene_id}/refresh

​
POST /shadingscenes//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//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.