Create a tag

post/tags
Internal-Use Only

Create a tag with the given content. If the user does not have the appropriate authorization to create tags and for the members to be added to the given tag then the create operation fails with a 403 Forbidden error.

Request Samples

1

Response Samples

1{
2  "creationTimeStamp": "2021-04-13T00:00:00Z",
3  "createdBy": "sasuser",
4  "modifiedTimeStamp": "2021-04-13T00:00:00Z",
5  "modifiedBy": "sasuser",
6  "id": "a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
7  "links": [
8    {
9      "method": "GET",
10      "rel": "self",
11      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e?memberStart=0&memberLimit=2147483647",
12      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e?memberStart=0&memberLimit=2147483647",
13      "type": "application/vnd.sas.metadata.tag"
14    },
15    {
16      "method": "GET",
17      "rel": "up",
18      "href": "/catalog/tags",
19      "uri": "/catalog/tags",
20      "type": "application/vnd.sas.collection",
21      "itemType": "application/vnd.sas.metadata.tag.summary"
22    },
23    {
24      "method": "PUT",
25      "rel": "update",
26      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
27      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
28      "type": "application/vnd.sas.metadata.tag",
29      "responseType": "application/vnd.sas.metadata.tag"
30    },
31    {
32      "method": "DELETE",
33      "rel": "delete",
34      "href": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e",
35      "uri": "/catalog/tags/a56ce67a-54e0-44e4-bce2-2398a8b27b2e"
36    }
37  ],
38  "version": 1,
39  "name": "Sales",
40  "members": {
41    "version": 1,
42    "type": "id",
43    "template": "/catalog/instances/{id}",
44    "resources": [
45      "b7a9f8f7-e939-2f4d-bb4b-b6740702f2bf",
46      "91411bc6-a921-e443-80f0-c89c9c9216e6"
47    ]
48  }
49}

Header Parameters

NameTypeRequiredDescription
Accept
string
false

The desired representation for the response.

Allowed values:
application/vnd.sas.metadata.tag+jsonapplication/vnd.sas.metadata.tag.summary+jsonapplication/json
Default:
application/vnd.sas.metadata.tag+json

Request Body

Information about a tag. Currently tags only supports tagging entities. Only /catalog/instances/{id} is accepted for the template property within members.

NameTypeRequiredDescription
id
string
true

The unique identifier of this tag. Immutable after creation.

name
string
true

The name of the tag; the maximum length is 100.

creationTimeStamp
string<date-time>
false

The date and time this object was created, in the format of YYYY-MM-DDThh:mm:ss.sssZ. The value is ignored on input.

modifiedTimeStamp
string<date-time>
false

The date and time this object was last modified, in the format of YYYY-MM-DDThh:mm:ss.sssZ. The value is ignored on input.

createdBy
string
false

The identity that created this object. The value is ignored on input.

modifiedBy
string
false

The identity that modified this object last. The value is ignored on input.

version
integer
false

The version of the media type.

links
array [Link]
false

The links that apply to the tag.

members
Selection
false

Identifies a set of resources.

Responses

StatusMeaningDescription
201CreatedCreated. The tag has been created. HeadersSchema
400Bad RequestBad request (the request is not well-formed).Schema
401UnauthorizedNot authenticated.Schema
403ForbiddenThe user does not have permission to complete this request.Schema