# Update callbacks

Create or update callbacks for the given contract.
This is used to upsert (insert or update) all callbacks at once.
Keep in mind that callbacks can be used by multiple parties (Omnia internal, Omnia Plugins, Users).
It's strongly recommended to provide your callbacks with a unique name to easily identify them later.
To update a single callback, you must also provide all other callbacks to ensure no callbacks from other parties are lost.
To delete all callbacks, you can provide an empty list.


Endpoint: PUT /api/2/v/contracts/{contractId}/settings/callbacks
Version: 0.0.7228
Security: BasicAuth, BearerAuth

## Path parameters:

  - `contractId` (string, required)
    Unique identifier of the contract
    Example: "qbcxvb"

## Request fields (application/json):

  - `pricemonitorCompleted` (array, required)
    A list of callbacks that are triggered when the "Pricemonitor Completed" event occurs, which means: 1. A monitoring task (fetching offers) has successfully finished, and/or 2. The price recommendation calculation task has been completed.

  - `pricemonitorCompleted.method` (string)
    The HTTP method to use when making the request. Supported methods are GET and POST. If not provided, the default method is GET.

  - `pricemonitorCompleted.name` (string)
    An optional name for the callback, used for identification purposes.

  - `pricemonitorCompleted.bodyTemplate` (string)
    An optional Mustache template to define the body of the request. The following placeholders are available in the template: - startTime: The time when the monitoring task started (in ISO 8601 format). - contractId: The unique identifier of the contract. Example default template: {"startTime":"{{startTime}}"}.

  - `pricemonitorCompleted.url` (string, required)
    The URL to which the callback request will be sent.

  - `pricemonitorCompleted.headers` (object, required)
    A map of HTTP headers to be included in the request.

## Response 200 fields (application/json):

  - `pricemonitorCompleted` (array, required)
    A list of callbacks that are triggered when the "Pricemonitor Completed" event occurs, which means: 1. A monitoring task (fetching offers) has successfully finished, and/or 2. The price recommendation calculation task has been completed.

  - `pricemonitorCompleted.method` (string)
    The HTTP method to use when making the request. Supported methods are GET and POST. If not provided, the default method is GET.

  - `pricemonitorCompleted.name` (string)
    An optional name for the callback, used for identification purposes.

  - `pricemonitorCompleted.bodyTemplate` (string)
    An optional Mustache template to define the body of the request. The following placeholders are available in the template: - startTime: The time when the monitoring task started (in ISO 8601 format). - contractId: The unique identifier of the contract. Example default template: {"startTime":"{{startTime}}"}.

  - `pricemonitorCompleted.url` (string, required)
    The URL to which the callback request will be sent.

  - `pricemonitorCompleted.headers` (object, required)
    A map of HTTP headers to be included in the request.