POST [/instances/$INSTANCE]/private/pots

This is used to create a pot.

Required permission: pots-write

Request:

The request must be a PotAddRequest.

Response:

200 OK:

The backend has successfully added a new pot. Returns a PotAddedResponse.

404 Not found:

The merchant instance is unknown.

409 Conflict:

A pot with this name already exists. Returned with TALER_EC_MERCHANT_PRIVATE_MONEY_POT_CONFLICTING_NAME.

413 Request entity too large:

The uploaded body is to long, it exceeds the size limit. Returned with an error code of TALER_EC_GENERIC_UPLOAD_EXCEEDS_LIMIT.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_STORE_FAILED.

Details:

interface PotAddRequest {

  // Description of the pot. Possibly included
  // in the pot message.
  description: string;

  // Name of the pot. Must be unique per instance.
  pot_name: string;

}

interface PotAddedResponse {

  // Unique ID for the pot.
  pot_serial_id: Integer;

}