Opportunities

Update an opportunity for the authenticated operator

Changed on

Replaces the writable representation of an opportunity. All required writable fields must be sent on every request; omitting an optional field (dateTo, url, or caregiverBenefit) clears its current value. A real change to the benefit economics on a scheduled/published/suspended opportunity moves it back to review (test_pending); every other change applies immediately. The current updatedAt must be echoed back for optimistic-concurrency control.

put/operator/opportunities/{opportunityId}

Request

  • Base URL: https://api.ced.pagopa.it/api/ced-portal/v1
  • URL: https://api.ced.pagopa.it/api/ced-portal/v1/operator/opportunities/{opportunityId}
  • Auth: HTTP bearer

Path parameters

opportunityIdstring required

Request body

updatedAtstring date-time required

Value previously read from the opportunity, echoed back for optimistic-concurrency control. A stale value yields 409.

dateFromstring date required
dateTostring date
urlstring uri
categoryIdstring required
nationalTerritoryboolean required
placeIdsstring[] required

Response

Opportunity updated (applied immediately or moved to review)

Changes