# Key Results

## List key results

 - [GET /rest/v2/key_results](https://apidocs.rhythms.ai/rest/v2/key-results/get_rest_v2_key_results.md): Retrieves all key results via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, type, current_status, uuid, status, last_checkin_date, time_period_uuid.

Available ransackable associations and their attributes:
- time_period: time_period_uuid, time_period_name
- owners: owners_uuid, owners_display_name, owners_status, owners_manager_uuid, owners_license_type, owners_display_name, owners_status, owners_manager_uuid, owners_license_type
- labels: labels_uuid, labels_name, labels_parent_uuid, labels_is_group
- ancestors: ancestors_uuid, ancestors_type, ancestors_current_status, ancestors_uuid, ancestors_status, ancestors_last_checkin_date, ancestors_time_period_uuid
- teams: teams_uuid, teams_display_name, teams_parent_uuid, teams_status, teams_name, teams_is_org, teams_parent_uuid
- links_as_child: links_as_child_uuid, links_as_child_ancestor_uuid

## Create a new key result

 - [POST /rest/v2/key_results](https://apidocs.rhythms.ai/rest/v2/key-results/post_rest_v2_key_results.md): Creates a new key result with the provided attributes

## Get a specific key result

 - [GET /rest/v2/key_results/{id}](https://apidocs.rhythms.ai/rest/v2/key-results/get_rest_v2_key_results_id.md): Retrieves detailed information about a specific key result by its UUID

## Update a key result

 - [PUT /rest/v2/key_results/{id}](https://apidocs.rhythms.ai/rest/v2/key-results/put_rest_v2_key_results_id.md): Updates an existing key result with the specified attributes

## Delete a key result

 - [DELETE /rest/v2/key_results/{id}](https://apidocs.rhythms.ai/rest/v2/key-results/delete_rest_v2_key_results_id.md): Deletes a key result and optionally its hierarchy