v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
Tournament Free Agency

Revoke a pickup offer your team sent

Withdraws a pending free-agent pickup offer that one of your teams sent. Authority is the SENDING side of the offer: you must be the captain, co-captain, or organization owner of the team that made it, which is the mirror of the respond endpoint, where only the agent the offer is addressed to may act.

The offer must still be PENDING. One that has been accepted, declined, expired, or already revoked answers 409 error_free_agent_offer_not_pending - so unlike check-in this is not retry-safe, and a second call after a successful one is a conflict rather than a no-op. Use it to free yourself to send a fresh offer to the same agent, which is otherwise blocked by 409 error_free_agent_offer_exists.

Revoking is silent: the agent is not notified, the offer simply disappears from their inbox. Nothing is rostered or released, because a pending offer never rostered anyone.

An offerId belonging to a different tournament answers 404 error_tournament_not_found. Requires the tournaments actor free_agency capability.

post/tournaments/{identifier}/free-agency/offers/{offerId}/revoke

Path parameters

identifierstring required

Tournament slug.

Tournament slug.

offerIdstring required

Free-agent pickup offer ID, as returned by GET /tournaments/{identifier}/me - inbound offers under offers.

Free-agent pickup offer ID, as returned by GET /tournaments/{identifier}/me - inbound offers under offers.

Response

The offer was revoked.

successtrue required

Always true; failures are error responses.

timestampstring required

Response generation time (ISO 8601).