Toshl Developer

Merge tags

Merge multiple tags into one. All entries and budgets with selected tags will be updated. When merging tags must be set, but only one of the remainig parameters may be set. After merging the selected tags will be deleted.

Some related data is updated asynchronously. Clients can set an additional GET parameter immediate_update which dictates that those values should be updated immediately in current request. Such a request may take longer to complete.

POST /tags/merge

Required scope:

Parameters

tags *
required
array

Tag ids to merge.

tag
optional
string

Tag id to merge selected tags into.

category
optional
string

Category id to merge selected tags into.

account
optional
string

Account id to merge selected tags into.

* denotes required field/parameter.

Request

$ curl https://api.toshl.com/tags/merge \
  -H "Authorization: Bearer T9cE5asGnuyYCCqIZFoWjFHvNbvVqHjl" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"tags": ["42", "43"], "tag": "44"}'

Response

HTTP/1.1 204 No Content