Tags

Tags Endpoint Reference

Tags are user-defined fields for programs.  Each tag may apply to one or more program types and can be either required or optional, depending on the how the tag was defined.  Tags may also provide a list of allowable values which must be selected from for use.

Query

Tags are queried with the standard asset pattern, but do not have an endpoint for By Id.  The list of allowable values for a tag is only returned when the tag is queried by name.

Get Tags

By Name

Update

The Update Program Tag endpoint allows you to update the value for a given tag type.  The endpoint takes an id and tagType path parameters which specify the program id, and the tag type to update.  A tagValue query parameter is used to specify the new value for the tag type.  All parameters are required.

Tags can be updated en mass using the Update Program Metadata endpoint.  An example of that can be found here.

Delete

The Delete Program Tag endpoint allows you to delete a non-required tag type.  The endpoint takes id and tagType path parameters which specify the program id, and the tag type to delete.