client.media.list_optimizations

A method of the Media endpoint.

list_optimizations(*, archived: str = None, limit: int = None, page_num: int = None, order: str = None, order_dir: str = None, iterator: bool = None) ListResponse | PaginatedResponse

List all optimizations

API URL: GET /media/optimizations

import civis
client = civis.APIClient()
response = client.media.list_optimizations(...)
Parameters:
archivedstr, optional

The archival status of the items to return. One of: true, false, all. A blank value is read as ‘false’, which is also the default.

limitint, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_numint, optional

Page number of the results to return. Defaults to the first page, 1.

orderstr, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, author, name.

order_dirstr, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iteratorbool, optional

If True, return a generator (specifically, a civis.PaginatedResponse object) to iterate over all responses. Use it when more results than the maximum allowed by ‘limit’ are needed. When True, ‘page_num’ is ignored. If False, return a civis.ListResponse object (= a list of civis.Response objects), whose size is determined by ‘limit’. Defaults to False.

Returns:
civis.ListResponse | civis.PaginatedResponse
  • idint

    The optimization ID.

  • authorcivis.Response
    • idint

      The ID of this user.

    • namestr

      This user’s name.

    • usernamestr

      This user’s username.

    • initialsstr

      This user’s initials.

    • onlinebool

      Whether this user is online.

  • namestr

    The name of the optimization.

  • created_at : str (time)

  • updated_at : str (time)

  • finished_atstr (date-time)

    The end time of the last run.

  • statestr

    The state of the last run.

  • last_run_idint

    The ID of the last run.

  • spot_order_idint

    The ID for the spot order produced by the optimization.

  • archivedbool

    The archival status of the requested item(s).