Claim the oldest pending command for any of the given locations, and of one of ops when given.
The request is held open while no command is pending: up to 25 seconds, or hold_ms when given. It answers 200 with the command as soon as one is queued, or 204 with no body when the time passes. A claimed command is held by its claim_token until its lease ends, shortly after its deadline_at, and takes its result until then. A claim repeating a claim_key gets back the command that key holds, whatever ops says, while that command has no result, its lease has not ended and the claim names its location, so a claim whose answer was lost loses no command. Every location must be one the token can access, or the whole claim is refused with 403. A malformed field is refused with 400, and nothing is claimed.
Note: This route requires that your application gets allow-listed. See: KumeteWeb.Plugs.RateLimitV4 for reference. If you need to add a new application to the allow-list, please contact the team responsible for Kumete [marketplace-team].
Required scope: write_integration_commands.
204No command was queued within the hold: 25 seconds, or hold_ms.
