Tag (Collection)


Get all tags

GET https://apis.wso2.com/api/am/store/v0.13/tags

This operation can be used to retrieve a list of tags that are already added to APIs. `X-WSO2-Tenant` header can be used to retrive tags that belongs to a different tenant domain. If not specified super tenant will be used. If Authorization header is present in the request, the user's tenant associated with the access token will be used. **NOTE:** * This operation does not require an Authorization header by default. But in order to see a restricted API's tags, you need to provide Authorization header.

OAuth 2.0 Scope

Not required

Request

GET https://localhost:9443/api/am/store/v0.13/tags

Response

HTTP/1.1 200 OK Content-Type: application/json { "previous": "", "list": [ { "weight": 1, "name": "mobile" }, { "weight": 1, "name": "multimedia" }, { "weight": 1, "name": "phone" } ], "count": 3, "next": "" }

Sample CURL

curl "https://localhost:9443/api/am/store/v0.13/tags"

Sample CURL - for tenant

curl -k -H "X-WSO2-Tenant:test.com" https://localhost:9443/api/am/store/v0.13/tags

Parameters

Type Name Description Schema Default
Query

limit

optional

Maximum size of resource array to return.

Integer

25

Query

offset

optional

Starting point within the complete list of items qualified.

Integer

0

Header

X-WSO2-Tenant

optional

For cross-tenant invocations, this is used to specify the tenant domain, where the resource need to be retirieved from.

String

Header

Accept

optional

Media types acceptable for the response. Default is application/json.

String

application/json

Header

If-None-Match

optional

Validator for conditional requests; based on the ETag of the formerly retrieved variant of the resource.

String

Responses

HTTP Code Description Schema

200

OK. Tag list is returned.

TagList

304

Not Modified. Empty body because the client has already the latest version of the requested resource (Will be supported in future).

404

Not Found. Requested API does not exist.

Error

406

Not Acceptable. The requested media type is not supported

Error