Skip to main content

Preview valid placements for a model

GET 
/instance/previews

Return candidate placements for a model before launch. This is the best first step when you want to see what Skulk can place on the current node or cluster. Pass excluded_node_ids (repeatable) to mirror the excluded_nodes field on POST /place_instance and preview against the post-exclusion topology. Besides the planner's ranked pick per placement shape, the response includes per-host single-node previews marked alternative: true for every other host that passes admission, so heterogeneous fleets expose the full set of valid hosts rather than only the ranking winner.

Request​

Responses​

Successful Response