Platforms Agents Tag endpoints expose functionality associated with tags given to agents on the platform. Agent tags provide a short name which can be used to identify an agent.
Attention!
All Platforms Agents Tag endpoints require a JWT bearer token obtained through the
POST /authenticate
or PUT /authenticate
endpoints.
Retrieve the tag of the specified agent.
- Authorization:
BEARER <jwt_access_token>
- With valid BEARER token on success:
200 OK
Content Type: application/json
Body:
{ "tag": "<tag>" }
- With valid BEARER token on success:
- With valid BEARER token on failure:
400 Bad Request
Content Type:
application/json
Body:
{ "error": "<Error Message>" }
- With valid BEARER token on failure:
With invalid BEARER token:
401 Unauthorized
Set the tag to an agent installed on the platform.
Authorization:
BEARER <jwt_token>
Content Type:
application/json
Body:
{ "tag": "<tag>" }
With valid BEARER token on success:
204 No Content
- With valid BEARER token on failure:
400 Bad Request
Content Type:
application/json
Body:
{ "error": "<Error Message>" }
- With valid BEARER token on failure:
With invalid BEARER token:
401 Unauthorized
Remove the tag from an agent installed on a VOLTTRON platform.
- Authorization:
BEARER <jwt_access_token>
With valid BEARER token on success:
204 No Content
- With valid BEARER token on failure:
400 Bad Request
Content Type:
application/json
Body:
{ "error": "<Error Message>" }
- With valid BEARER token on failure:
With invalid BEARER token:
401 Unauthorized
.. toctree:: :hidden: self