deleteCommerceWatchlistByWatchlistidWithHttpInfo method

Future<Response> deleteCommerceWatchlistByWatchlistidWithHttpInfo(String watchlistid)

Delete a watchlist, keeping a recoverable copy

A watchlist is a viewer's saved list of movies — a user id, an email, and the movies themselves. It stores WHOLE MOVIE SNAPSHOTS rather than movie ids, so a list goes stale the moment a film record changes and grows without bound as it fills. Removes the addressed row and answers 204 with no body. Before the live row goes it is written once more under a deleted tombstone kind, so a deletion leaves a recoverable copy rather than destroying the record outright — and a tombstone that cannot be written fails the call with 500 before anything is removed. The id is resolved inside the caller org's own namespace, so an absent or foreign id is 404. Any valid access token reaches it. The per-kind permission table has no entry for watchlist, so the scaffold skips that second check with a warning and the gate above is the whole authorization story.

Note: This method returns the HTTP Response.

Parameters:

• String watchlistid (required):

Implementation

Future<Response> deleteCommerceWatchlistByWatchlistidWithHttpInfo(String watchlistid,) async {
  // ignore: prefer_const_declarations
  final path = r'/v1/commerce/watchlist/{watchlistid}'
    .replaceAll('{watchlistid}', watchlistid);

  // ignore: prefer_final_locals
  Object? postBody;

  final queryParams = <QueryParam>[];
  final headerParams = <String, String>{};
  final formParams = <String, String>{};

  const contentTypes = <String>[];


  return apiClient.invokeAPI(
    path,
    'DELETE',
    queryParams,
    postBody,
    headerParams,
    formParams,
    contentTypes.isEmpty ? null : contentTypes.first,
  );
}