# Initiatives

## List initiatives

 - [GET /rest/v2/initiatives](https://apidocs.rhythms.ai/rest/v2/initiatives/get_rest_v2_initiatives.md): Retrieves all initiatives 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 initiative

 - [POST /rest/v2/initiatives](https://apidocs.rhythms.ai/rest/v2/initiatives/post_rest_v2_initiatives.md): Creates a new initiative with the provided attributes

## Get a specific initiative

 - [GET /rest/v2/initiatives/{id}](https://apidocs.rhythms.ai/rest/v2/initiatives/get_rest_v2_initiatives_id.md): Retrieves detailed information about a specific initiative by its UUID

## Update an initiative

 - [PUT /rest/v2/initiatives/{id}](https://apidocs.rhythms.ai/rest/v2/initiatives/put_rest_v2_initiatives_id.md): Updates an existing initiative with the specified attributes

## Delete an initiative

 - [DELETE /rest/v2/initiatives/{id}](https://apidocs.rhythms.ai/rest/v2/initiatives/delete_rest_v2_initiatives_id.md): Deletes an initiative and optionally its hierarchy