Update Tag

POST

Updates a tag’s information.

Request

This endpoint expects an object.

idstringRequired

The ID of the tag to update.

allowed_valuesobjectOptional

Specifies an update to a tag’s allowed values.

descriptionstringOptional

The updated description of the tag.

namestringOptional

The updated name of the tag. The name must be unique across all tags.

Response

The response for updating a tag.

tagobject

POST

1 curl -X POST https://api.devrev.ai/tags.update \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "id": "TAG-12345"
6 }'

200Successful

1 {
2   "tag": {
3     "id": "id",
4     "name": "name",
5     "allowed_values": [
6       "allowed_values"
7     ],
8     "created_by": {
9       "type": "sys_user",
10       "id": "created_by",
11       "display_id": "created_by",
12       "display_name": "created_by",
13       "display_picture": {
14         "id": "id"
15       },
16       "email": "created_by",
17       "full_name": "created_by",
18       "state": "active"
19     },
20     "created_date": "2023-01-01T12:00:00Z",
21     "description": "description",
22     "display_id": "display_id",
23     "modified_by": {
24       "type": "sys_user",
25       "id": "modified_by",
26       "display_id": "modified_by",
27       "display_name": "modified_by",
28       "display_picture": {
29         "id": "id"
30       },
31       "email": "modified_by",
32       "full_name": "modified_by",
33       "state": "active"
34     },
35     "modified_date": "2023-01-01T12:00:00Z"
36   }
37 }

Built with

1	curl -X POST https://api.devrev.ai/tags.update \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"id": "TAG-12345"
6	}'

1	{
2	"tag": {
3	"id": "id",
4	"name": "name",
5	"allowed_values": [
6	"allowed_values"
7	],
8	"created_by": {
9	"type": "sys_user",
10	"id": "created_by",
11	"display_id": "created_by",
12	"display_name": "created_by",
13	"display_picture": {
14	"id": "id"
15	},
16	"email": "created_by",
17	"full_name": "created_by",
18	"state": "active"
19	},
20	"created_date": "2023-01-01T12:00:00Z",
21	"description": "description",
22	"display_id": "display_id",
23	"modified_by": {
24	"type": "sys_user",
25	"id": "modified_by",
26	"display_id": "modified_by",
27	"display_name": "modified_by",
28	"display_picture": {
29	"id": "id"
30	},
31	"email": "modified_by",
32	"full_name": "modified_by",
33	"state": "active"
34	},
35	"modified_date": "2023-01-01T12:00:00Z"
36	}
37	}