# {{classname}} All URIs are relative to *https://demo.firefly-iii.org/api* Method | HTTP request | Description ------------- | ------------- | ------------- [**DeleteObjectGroup**](ObjectGroupsApi.md#DeleteObjectGroup) | **Delete** /v1/object-groups/{id} | Delete a object group. [**GetObjectGroup**](ObjectGroupsApi.md#GetObjectGroup) | **Get** /v1/object-groups/{id} | Get a single object group. [**ListBillByObjectGroup**](ObjectGroupsApi.md#ListBillByObjectGroup) | **Get** /v1/object-groups/{id}/bills | List all bills with this object group. [**ListObjectGroups**](ObjectGroupsApi.md#ListObjectGroups) | **Get** /v1/object-groups | List all oject groups. [**ListPiggyBankByObjectGroup**](ObjectGroupsApi.md#ListPiggyBankByObjectGroup) | **Get** /v1/object-groups/{id}/piggy-banks | List all piggy banks related to the object group. [**UpdateObjectGroup**](ObjectGroupsApi.md#UpdateObjectGroup) | **Put** /v1/object-groups/{id} | Update existing object group. # **DeleteObjectGroup** > DeleteObjectGroup(ctx, id, optional) Delete a object group. Delete a object group. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **id** | **string**| The ID of the object group. | **optional** | ***ObjectGroupsApiDeleteObjectGroupOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiDeleteObjectGroupOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | ### Return type (empty response body) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### 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) # **GetObjectGroup** > ObjectGroupSingle GetObjectGroup(ctx, id, optional) Get a single object group. Get a single object group. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **id** | **string**| The ID of the object group. | **optional** | ***ObjectGroupsApiGetObjectGroupOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiGetObjectGroupOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | ### Return type [**ObjectGroupSingle**](ObjectGroupSingle.md) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/vnd.api+json, 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) # **ListBillByObjectGroup** > BillArray ListBillByObjectGroup(ctx, id, optional) List all bills with this object group. List all bills with this object group. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **id** | **string**| The ID of the account. | **optional** | ***ObjectGroupsApiListBillByObjectGroupOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiListBillByObjectGroupOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | **limit** | **optional.Int32**| Number of items per page. The default pagination is per 50 items. | **page** | **optional.Int32**| Page number. The default pagination is per 50 items. | ### Return type [**BillArray**](BillArray.md) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/vnd.api+json, 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) # **ListObjectGroups** > ObjectGroupArray ListObjectGroups(ctx, optional) List all oject groups. List all oject groups. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **optional** | ***ObjectGroupsApiListObjectGroupsOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiListObjectGroupsOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | **limit** | **optional.Int32**| Number of items per page. The default pagination is per 50 items. | **page** | **optional.Int32**| Page number. The default pagination is per 50 items. | ### Return type [**ObjectGroupArray**](ObjectGroupArray.md) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/vnd.api+json, 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) # **ListPiggyBankByObjectGroup** > PiggyBankArray ListPiggyBankByObjectGroup(ctx, id, optional) List all piggy banks related to the object group. This endpoint returns a list of all the piggy banks connected to the object group. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **id** | **string**| The ID of the account. | **optional** | ***ObjectGroupsApiListPiggyBankByObjectGroupOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiListPiggyBankByObjectGroupOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | **limit** | **optional.Int32**| Number of items per page. The default pagination is per 50 items. | **page** | **optional.Int32**| Page number. The default pagination is per 50 items. | ### Return type [**PiggyBankArray**](PiggyBankArray.md) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/vnd.api+json, 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) # **UpdateObjectGroup** > ObjectGroupSingle UpdateObjectGroup(ctx, body, title, order, id, optional) Update existing object group. Update existing object group. ### Required Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. **body** | [**ObjectGroupUpdate**](ObjectGroupUpdate.md)| JSON array with updated piggy bank information. See the model for the exact specifications. | **title** | **string**| | **order** | **int32**| | **id** | **string**| The ID of the object group | **optional** | ***ObjectGroupsApiUpdateObjectGroupOpts** | optional parameters | nil if no parameters ### Optional Parameters Optional parameters are passed through a pointer to a ObjectGroupsApiUpdateObjectGroupOpts struct Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **xTraceId** | [**optional.Interface of string**](.md)| Unique identifier associated with this request. | ### Return type [**ObjectGroupSingle**](ObjectGroupSingle.md) ### Authorization [firefly_iii_auth](../README.md#firefly_iii_auth), [local_bearer_auth](../README.md#local_bearer_auth) ### HTTP request headers - **Content-Type**: application/json, application/x-www-form-urlencoded - **Accept**: application/vnd.api+json, 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)