Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

POST /ariel/taggedfieldcategories/{id}

SUMMARY Updates a category for tagged fields. To use this endpoint, you must have System Administrator or Security Admin permissions.

Updates a category for tagged fields. To use this endpoint, you must have System Administrator or Security Admin permissions.

Table 1: POST /ariel/taggedfieldcategories/{id} resource details:

POST /ariel/taggedfieldcategories/{id} resource details

MIME Type

application/json

Table 2: POST /ariel/taggedfieldcategories/{id} request parameter details:

POST /ariel/taggedfieldcategories/{id} request parameter details

Parameter Type Optionality Data Type MIME Type Description

id

path

Required

Number (Integer)

text/plain

The ID of the category that you want to update.

Table 3: POST /ariel/taggedfieldcategories/{id} request body details:

POST /ariel/taggedfieldcategories/{id} request body details

Parameter Data Type MIME Type Description Sample

body

Object

application/json

The updated structure for the category. Only the name field can be set when updating a category. All other fields are ignored.
  • name - String - The name of the category for tagged fields.

{ "name": "String" }

Table 4: POST /ariel/taggedfieldcategories/{id} response codes:

POST /ariel/taggedfieldcategories/{id} response codes

HTTP Response Code Unique Code Description

200

The category was updated.

404

7000

The specified ID does not exist.

409

7001

A category already exists with the specified name.

422

7002

The specified name must be between 1 and 255 (inclusive) characters.

500

1027

An error occurred while updating the category.

Response Description

The updated category with the specified ID. A category object contains the following fields:
  • id - Long - The ID of the category for tagged fields.
  • name - String - The name of the category for tagged fields.
  • uuid - String - The ID of the category for tagged fields, represented as a UUID.
  • modified_date - Long - The time stamp that the category was last modified, specified in milliseconds since epoch.
  • creation_date - Long - The time stamp that the category was created, specified in milliseconds since epoch.

Response Sample