Skip to main content
PUT
/
v0
/
tags
/
{tagId}
Update a tag
curl --request PUT \
  --url https://external.pleo.io/v0/tags/{tagId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json;charset=UTF-8' \
  --data '
{
  "archived": false,
  "code": "12345",
  "name": "Lunch allowance",
  "otherDimensionValues": [
    "value1",
    "value2"
  ]
}
'
{
  "data": {
    "archived": false,
    "code": "12345",
    "createdAt": "2023-08-23T03:11:48Z",
    "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
    "updatedAt": "2023-08-23T03:11:48Z",
    "name": "Lunch allowance"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tagId
string<uuid>
required

Unique identifier of the tag to update.

Body

application/json;charset=UTF-8
​
archived
boolean
required

Boolean flag used to determine whether the tag is archived.

Example:

false

​
code
string
required

Code used in the external ERP/accounting system to identify the tag.

Example:

"12345"

​
name
string

User readable name of the tag.

Example:

"Lunch allowance"

​
otherDimensionValues
string[]

Dimension values outside the two main dimensions ordered by display order. Values not provided will not be changed.Values will be ignored if there is not enough dimensions to add them to

Dimension values outside the two main dimensions ordered by display order. Values not provided will not be changed.Values will be ignored if there is not enough dimensions to add them to

Example:
["value1", "value2"]

Response

Tag updated successfully.

​
data
object
required