find_app_projects

toloka.client.TolokaClient.find_app_projects | Source code

Finds App projects that match certain criteria.

The number of returned projects is limited. To find remaining projects call find_app_projects with updated search criteria.

To iterate over all matching projects you may use the get_app_projects method.

Parameters description

Parameters	Type	Description
`app_id`	Optional[str]	Projects created using the solution with the specified ID.
`parent_app_project_id`	Optional[str]	Projects cloned from the project with the specified ID. Projects can be cloned in the web version of Toloka.
`status`	Optional[AppProject.Status]	App project status. Refer to the AppProject.Status page for more information on the available `status` values.
`after_id`	Optional[str]	The ID of a project used for cursor pagination.
`scope`	Optional[AppProjectSearchRequest.Scope]	Values: `'MY'` — Projects created by you. `'COMPANY'` — Projects created by requesters from your company. `'REQUESTER_LIST'` — Projects created by requesters in the `requester_ids` list.
`requester_ids`	Union[str, List[str], None]	A list with requester IDs separated by a comma. Use the list with parameter `scope = REQUESTER_LIST`.
`id_gt`	Optional[str]	Projects with IDs greater than the specified value.
`id_gte`	Optional[str]	Projects with IDs greater than or equal to the specified value.
`id_lt`	Optional[str]	Projects with IDs less than the specified value.
`id_lte`	Optional[str]	Projects with IDs less than or equal to the specified value.
`name_gt`	Optional[str]	Projects with a name lexicographically greater than the specified value.
`name_gte`	Optional[str]	Projects with a name lexicographically greater than or equal to the specified value.
`name_lt`	Optional[str]	Projects with a name lexicographically less than the specified value.
`name_lte`	Optional[str]	Projects with a name lexicographically less than or equal to the specified value.
`created_gt`	Optional[datetime]	Projects created after the specified date.
`created_gte`	Optional[datetime]	Projects created after or on the specified date.
`created_lt`	Optional[datetime]	Projects created before the specified date.
`created_lte`	Optional[datetime]	Projects created before or on the specified date.
`sort`	Union[List[str], AppProjectSortItems, None]	The order and direction of sorting the results.
`limit`	Optional[int]	Returned projects limit. The maximum allowed value: 5000.

Returns:

Found projects and a flag showing whether there are more matching projects exceeding the limit.
Return type:

AppProjectSearchResult

Examples:

Searching active projects based on the App solution with the specified ID.

search = toloka_client.find_app_projects(
    app_id='9lZaMl363jahzra1rrYq', status='READY')
for app_project in search.content:
    print(app_project.id, app_project.name)
if search.has_more:
    print('There are more App projects...')

Last updated: August 28, 2023

Toloka-Kit

Overview Getting API key Quick start

Recipes

Reference

toloka.client

toloka.async_client

toloka.autoquality [autoquality]

toloka.metrics

toloka.streaming