# \StagesApi
All URIs are relative to *https://api.pipedrive.com/v1*
[**add_stage**](StagesApi.md#add_stage) | **POST** /stages | Add a new stage
[**delete_stage**](StagesApi.md#delete_stage) | **DELETE** /stages/{id} | Delete a stage
[**delete_stages**](StagesApi.md#delete_stages) | **DELETE** /stages | Delete multiple stages in bulk
[**get_stage**](StagesApi.md#get_stage) | **GET** /stages/{id} | Get one stage
[**get_stage_deals**](StagesApi.md#get_stage_deals) | **GET** /stages/{id}/deals | Get deals in a stage
[**get_stages**](StagesApi.md#get_stages) | **GET** /stages | Get all stages
[**update_stage**](StagesApi.md#update_stage) | **PUT** /stages/{id} | Update stage details
## add_stage
> crate::models::StageResponse200 add_stage(add_stage_request)
Add a new stage
Adds a new stage, returns the ID upon success.
### Parameters
**add_stage_request** | Option<[**AddStageRequest**](AddStageRequest.md)> | | |
### Return type
[**crate::models::StageResponse200**](stageResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## delete_stage
> crate::models::DeleteStageResponse200 delete_stage(id)
Delete a stage
Marks a stage as deleted.
### Parameters
**id** | **i32** | The ID of the stage | [required] |
### Return type
[**crate::models::DeleteStageResponse200**](deleteStageResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## delete_stages
> crate::models::DeleteStagesResponse200 delete_stages(ids)
Delete multiple stages in bulk
Marks multiple stages as deleted.
### Parameters
**ids** | **String** | The comma-separated stage IDs to delete | [required] |
### Return type
[**crate::models::DeleteStagesResponse200**](deleteStagesResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_stage
> crate::models::GetStageResponse200 get_stage(id, everyone)
Get one stage
Returns data about a specific stage.
### Parameters
**id** | **i32** | The ID of the stage | [required] |
**everyone** | Option<**f32**> | If `everyone=1` is provided, deals summary will return deals owned by every user | |
### Return type
[**crate::models::GetStageResponse200**](getStageResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_stage_deals
> crate::models::GetStageDealsResponse200 get_stage_deals(id, filter_id, user_id, everyone, start, limit)
Get deals in a stage
Lists deals in a specific stage.
### Parameters
**id** | **i32** | The ID of the stage | [required] |
**filter_id** | Option<**i32**> | If supplied, only deals matching the given filter will be returned | |
**user_id** | Option<**i32**> | If supplied, `filter_id` will not be considered and only deals owned by the given user will be returned. If omitted, deals owned by the authorized user will be returned. | |
**everyone** | Option<**f32**> | If supplied, `filter_id` and `user_id` will not be considered – instead, deals owned by everyone will be returned | |
**start** | Option<**i32**> | Pagination start | |[default to 0]
**limit** | Option<**i32**> | Items shown per page | |
### Return type
[**crate::models::GetStageDealsResponse200**](getStageDealsResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_stages
> crate::models::GetStagesResponse200 get_stages(pipeline_id, start, limit)
Get all stages
Returns data about all stages.
### Parameters
**pipeline_id** | Option<**i32**> | The ID of the pipeline to fetch stages for. If omitted, stages for all pipelines will be fetched. | |
**start** | Option<**i32**> | Pagination start | |[default to 0]
**limit** | Option<**i32**> | Items shown per page | |
### Return type
[**crate::models::GetStagesResponse200**](getStagesResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## update_stage
> crate::models::StageResponse200 update_stage(id, update_stage_request)
Update stage details
Updates the properties of a stage.
### Parameters
**id** | **i32** | The ID of the stage | [required] |
**update_stage_request** | Option<[**UpdateStageRequest**](UpdateStageRequest.md)> | | |
### Return type
[**crate::models::StageResponse200**](stageResponse200.md)
### Authorization
[api_key](../README.md#api_key), [oauth2](../README.md#oauth2)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)