Read Box

One box's state row and its full timeline, oldest event first.

Both path parameters are required because the ledger's primary key is composite: a provider-native id is unique only inside its own provider's namespace.

sandbox_id is a :path parameter because a provider-native id is allowed to contain slashes: an ECS task ARN is arn:aws:ecs:<region>:<account>:task/<cluster>/<id>, which the default converter splits into extra path segments so that no route matches at all. It is the last segment, so swallowing the remainder is unambiguous.

The timeline is capped like every other list here. A box that flapped between running and stopped for months has an unbounded event count, and an admin route that can return an unbounded body is a way to take the API down from a browser tab.