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.

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