offers
Módulo People · 8 operaciones
List offer rows
GET/offers
Terms issued to a person or organization: accepted, countered or declined. Returns a cursor page of offer rows the caller may see. The default order is `created_at` ascending. Supports sparse fieldsets and the filter grammar.
Create an offer
POST/offers
Terms issued to a person or organization: accepted, countered or declined. Creates an offer. Requires `Idempotency-Key`; a replay returns the original response. The organization is derived from the credential or the parent row, never from the body.
Get an offer
GET/offers/{id}
Terms issued to a person or organization: accepted, countered or declined. Returns one offer with its `ETag`. A offer the caller may not see returns 404.
Update an offer
PATCH/offers/{id}
Terms issued to a person or organization: accepted, countered or declined. Updates the fields sent; omitted fields are unchanged. Requires `If-Match` with the current `ETag`: a stale tag returns 412 and a missing tag returns 428.
Accept an offer
POST/offers/{id}/accept
Accepts the offer as the offered party and creates the engagement. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Decline an offer
POST/offers/{id}/decline
The applicant side declines the organization's terms; the offer and the application become Declined. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Counter an offer
POST/offers/{id}/counter
The applicant side counters the terms in force with its own, as a new version; the offer becomes Countered. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Withdraw an offer
POST/offers/{id}/withdraw
The organization withdraws an offer that is Sent or Countered; the application becomes Not Selected. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.