Upsert offering - Tradara

PUT /v1/firm-control/offerings

operationId: upsertOffering Enables or disables a firm product offering type for the active firm. Idempotent on offering_type.

Body

Field	Required	Notes
`offering_type`	yes	Offering type slug (e.g. `evaluation`, `funded`).
`firm_id`	no	Required when `X-Firm-ID` is absent.
`is_enabled`	no	When `true`, enables the offering. When `false`, disables it.

Example

curl -X PUT "$TRADARA_BASE_URL/v1/firm-control/offerings" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "offering_type": "evaluation",
    "is_enabled": true
  }'

Response — `200 OK`

Returns the updated full list of FirmOffering entries for the firm.

{
  "items": [
    {
      "id": "off_01HW...",
      "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
      "offering_type": "evaluation",
      "is_enabled": true,
      "enabled_at": "2026-06-26T16:00:00Z",
      "disabled_at": "",
      "updated_by_user_id": "usr_01HW...",
      "created_at": "2026-06-01T00:00:00Z",
      "updated_at": "2026-06-26T16:00:00Z"
    },
    {
      "id": "off_01HV...",
      "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
      "offering_type": "funded",
      "is_enabled": false,
      "enabled_at": "2026-05-01T00:00:00Z",
      "disabled_at": "2026-06-15T00:00:00Z",
      "updated_by_user_id": "usr_01HV...",
      "created_at": "2026-05-01T00:00:00Z",
      "updated_at": "2026-06-15T00:00:00Z"
    }
  ]
}

Errors

HTTP	Meaning
`400`	Missing `offering_type` or unknown value.
`502`	Downstream offerings service unreachable.