v1
latestOpenAPI 3.0.02026-07-175652103.9 KBRename a Tag
This function is an API endpoint that renames a tag in an address book. It is tagged with "address book" for OpenAPI documentation.
Parameters
-
ab: The identifier of the address book.
-
request: A JSON object containing the old and new names of the tag.
Returns
If successful, this function returns an ActionResponse::Empty object. <br> If the tag does not exist or the user is not authorized to access it, this function returns a status::Unauthorized error. <br>
Errors
This function will return an error if the system is in maintenance mode, or if the tag does not exist or the user is not authorized to access it.
Example
PUT /api/ab/tag/rename/018fab24-0ae5-731c-be23-88aa4518ea26 Content-Type: application/json
{"old": "tag1", "new": "tag2"}
Path parameters
Request body
Response
# 200 OK
This response is given when the request is successful.
The body is empty if there is no error,
The body contains a json object with the error {"error":"Error message"}