Award a dispatch to a vendor

Resolves vendor_name against the matter's qualified vendor set. An award requested through this endpoint does NOT commit the firm: it parks as a pending approval and returns 409, and the award commits when a person at the firm releases it from the approvals queue. A pre-authorization never covers a request made through this endpoint, so this holds whatever pre-authorized spending the firm has set. RBAC: the dispatch.award capability, or a partner token with the dispatch scope.

post/api/v1/dispatches/{dispatch_id}/award

Request

  • Base URL: https://scope.bid
  • URL: https://scope.bid/api/v1/dispatches/{dispatch_id}/award
  • Auth: HTTP bearer

Path parameters

dispatch_idstring required

Request body

vendor_namestring required

Response

Awarded. Not returned for an award requested through this endpoint today: the unconditional human-approval gate parks every such award (see 409), and the release happens from the firm's approvals queue, not by retrying this call.

Changes

No recorded changes to this operation across all 1 revision of this API.