POST new-vendor-requests/{id}/tags/

body = {"name": "Tag_To_Add"}

To add a tag to a New Vendor Request identified by {id} add a body to the request that will have one key pair: "name": "Tag_To_Add" .


POST /api/new-vendor-requests/20100/tags/

body = {"name": "Tag_To_Add"}

Request Parameters

Success Codes

HTTP Status CodeExceptionDescription
200Tag Already ExistsThe tag is not added because the New Vendor Request already has this tag.
201CreatedThe tag is added to the New Vendor Request.

Sample Response

Returns a JSON object that contains few important fields for the tag that was added. Example:

    "id": 475,
    "created": "2023-02-16T16:15:02.480204-05:00",
    "modified": "2023-02-16T16:15:02.480204-05:00",
    "name": "Tag_To_Add",
    "acct": 14268,
    "nvrs": [19030]

where some more important fields are:

KeyTypeSample ValueDescription
idNumber475The unique ID for the tag.
nameString“Tag_To_Add”The tag that was added.
nvrsArray of Numbers“nvrs”: [19030]An array of NVR ids to which this tag was added. It usually has one NVR id, since tags are per NVR.

Error Codes

HTTP Status CodeExceptionDescription
400Bad RequestThe request could not be understood by the server due to incorrect syntax. 20100
401UnauthenticatedThe request requires user authentication information. Your API token is missing or invalid.
403ForbiddenUnauthorized request. The client does not have access rights to the content. Unlike 401, the client’s identity is known to the server.
404Not FoundVendor {id} does not exist.


Service UnavailableThe request has failed due to a temporary failure of the server. You can try this request at a later time.

Calling the API