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/optimizationsimport 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.PaginatedResponseobject) 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 acivis.ListResponseobject (= a list ofcivis.Responseobjects), whose size is determined by ‘limit’. Defaults to False.
- Returns:
civis.ListResponse|civis.PaginatedResponse- idint
The optimization ID.
- author
civis.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.
- author
- 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).