12 KiB
{{classname}}
All URIs are relative to https://demo.firefly-iii.org/api
Method | HTTP request | Description |
---|---|---|
DeleteCategory | Delete /v1/categories/{id} | Delete a category. |
GetCategory | Get /v1/categories/{id} | Get a single category. |
ListAttachmentByCategory | Get /v1/categories/{id}/attachments | Lists all attachments. |
ListCategory | Get /v1/categories | List all categories. |
ListTransactionByCategory | Get /v1/categories/{id}/transactions | List all transactions in a category. |
StoreCategory | Post /v1/categories | Store a new category |
UpdateCategory | Put /v1/categories/{id} | Update existing category. |
DeleteCategory
DeleteCategory(ctx, id, optional) Delete a category.
Delete a category. Transactions will not be removed.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
id | string | The ID of the category. | |
optional | *CategoriesApiDeleteCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiDeleteCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
(empty response body)
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetCategory
CategorySingle GetCategory(ctx, id, optional) Get a single category.
Get a single category.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
id | string | The ID of the category. | |
optional | *CategoriesApiGetCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiGetCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | start | optional.String| A date formatted YYYY-MM-DD, to show spent and earned info. | end | optional.String| A date formatted YYYY-MM-DD, to show spent and earned info. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListAttachmentByCategory
AttachmentArray ListAttachmentByCategory(ctx, id, optional) Lists all attachments.
Lists all attachments.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
id | string | The ID of the category. | |
optional | *CategoriesApiListAttachmentByCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiListAttachmentByCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| 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
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListCategory
CategoryArray ListCategory(ctx, optional) List all categories.
List all categories.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *CategoriesApiListCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiListCategoryOpts struct
Name | Type | Description | Notes |
---|---|---|---|
xTraceId | optional.Interface of string | 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
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListTransactionByCategory
TransactionArray ListTransactionByCategory(ctx, id, optional) List all transactions in a category.
List all transactions in a category, optionally limited to the date ranges specified.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
id | string | The ID of the category. | |
optional | *CategoriesApiListTransactionByCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiListTransactionByCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| 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. | start | optional.String| A date formatted YYYY-MM-DD, to limit the result list. | end | optional.String| A date formatted YYYY-MM-DD, to limit the result list. | type_ | optional.Interface of TransactionTypeFilter| Optional filter on the transaction type(s) returned |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
StoreCategory
CategorySingle StoreCategory(ctx, body, createdAt, updatedAt, name, notes, spent, earned, optional) Store a new category
Creates a new category. The data required can be submitted as a JSON body or as a list of parameters.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | Category | JSON array or key=value pairs with the necessary category information. See the model for the exact specifications. | |
createdAt | time.Time | ||
updatedAt | time.Time | ||
name | string | ||
notes | string | ||
spent | **[]CategorySpent** | ||
earned | **[]CategoryEarned** | ||
optional | *CategoriesApiStoreCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiStoreCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, 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] [Back to Model list] [Back to README]
UpdateCategory
CategorySingle UpdateCategory(ctx, body, name, notes, id, optional) Update existing category.
Update existing category.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | CategoryUpdate | JSON array with updated category information. See the model for the exact specifications. | |
name | string | ||
notes | string | ||
id | string | The ID of the category. | |
optional | *CategoriesApiUpdateCategoryOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CategoriesApiUpdateCategoryOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, 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] [Back to Model list] [Back to README]