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]