TagsApi


Delete Tags relevant to an App

Delete Tags relevant to an App by AppId.

URL

http://apis.wso2.com/api/appm/publisher/v1.1/apps/{appType}/id/{appId}/tags

HTTP Method

DELETE

Scope

appm:create

CURL Example

curl -X DELETE -H "Authorization: Bearer 4be7890951f36d5c44a68d5a35227ceb" -H "Content-Type: application/json" -d '{"tags":["tag1","tag2"]}' "http://localhost:9763/api/appm/publisher/v1.1/apps/webapp/id/95e497dd-ebb0-414f-9718-88857a153780/tags"

Sample Response

HTTP/1.1 200 OK

Parameters

Type Name Description Schema Default
Path

appType

required

The App type (either Webapp/Mobile app).

String

Path

appId

required

**APP ID** consisting of the **UUID** of the App. The following combination is also accepted as a valid APP ID: the provider of the app, name of the app and the version. Should be formatted as **provider-name-version**.

String

Body

body

required

Tag object that needs to be added.

TagList (TagList)

Header

If-Match

optional

Validator for conditional requests; based on the ETag.

String

Header

If-Unmodified-Since

optional

Validator for conditional requests; based on the Last Modified header.

String

Responses

HTTP Code Description Schema

200

OK. Resource successfully deleted.

403

Forbidden. The request must be conditional but no condition has been specified.

Error

404

Not Found. Resource to be deleted does not exist.

Error

412

Precondition Failed. The request has not been performed because one of the preconditions is not met.

Error

Get all Tags of an App

Get a list of available Tags relevant to the given App Internal ID.

URL

http://apis.wso2.com/api/appm/publisher/v1.1/apps/{appType}/id/{appId}/tags

HTTP Method

GET

Scope

appm:read

CURL Example

curl -X GET -H "Authorization: Bearer e099014668a524870c2895fe0595f125" "http://localhost:9763/api/appm/store/v1.1/apps/webapp/tags"

Sample Response

HTTP/1.1 200 OK Content-Type: application/json {"tags":["tagA","tagB","tagC"]}

Parameters

Type Name Description Schema Default
Path

appType

required

The App type (either Webapp/Mobile app).

String

Path

appId

required

**APP ID** consisting of the **UUID** of the App. The following combination is also accepted as a valid APP ID: the provider of the app, name of the app and the version. Should be formatted as **provider-name-version**.

String

Header

Accept

optional

Media types acceptable for the response. Default is JSON.

String

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. List of tags is returned.

TagList

400

Bad Request. Invalid request or validation error.

Error

403

Forbidden. The request must be conditional but no condition has been specified.

Error

404

Not Found. The resource to be updated does not exist.

Error

Add a new tag

Add a new tag/tags to the tag collection of a given application type.

URL

http://apis.wso2.com/api/appm/publisher/v1.1/apps/{appType}/id/{appId}/tags

HTTP Method

PUT

Scope

appm:create

CURL Example

curl -X PUT -H "Authorization: Bearer 4be7890951f36d5c44a68d5a35227ceb" -H "Content-Type: application/json" -d '{"tags":["tagA","tagB","tagC"]}' "http://localhost:9763/api/appm/publisher/v1.1/apps/webapp/id/00fafc68-d8bb-498f-9ef3-afbb6db06826/tags"

Sample Request

{"tags":["tagA","tagB","tagC"]}

Sample Response

HTTP/1.1 200 OK

Parameters

Type Name Description Schema Default
Path

appType

required

The App type (either Webapp/Mobile app).

String

Path

appId

required

**APP ID** consisting of the **UUID** of the App. The following combination is also accepted as a valid APP ID: the provider of the app, name of the app and the version. Should be formatted as **provider-name-version**.

String

Body

body

required

Tag object that needs to be added.

TagList (TagList)

Header

Content-Type

required

Media type of the entity in the body. Default is JSON.

String

JSON

Header

If-Match

optional

Validator for conditional requests; based on the ETag.

String

Header

If-Unmodified-Since

optional

Validator for conditional requests; based on the Last Modified header.

String

Responses

HTTP Code Description Schema

200

OK.

400

Bad Request. Invalid request or validation error.

Error

403

Forbidden. The request must be conditional but no condition has been specified.

Error

404

Not Found. The resource to be updated does not exist.

Error

412

Precondition Failed. The request has not been performed because one of the preconditions is not met.

Error

Get all Tags

Get a list of available tags relevant to the given App type.

URL

http://apis.wso2.com/api/appm/publisher/v1.1/apps/{appType}/tags

HTTP Method

GET

Scope

appm:read

CURL Example

curl -X GET -H "Authorization: Bearer 0c0338592beefe7225bd6d869e93ca06" "http://localhost:9763/api/appm/publisher/v1.1/apps/webapp/tags"

Sample Response

[{"name":"webapptag1","noOfOccurrences":1},{"name":"webapptag2","noOfOccurrences":1},{"name":"webapptag3","noOfOccurrences":1}]

Parameters

Type Name Description Schema Default
Path

appType

required

The App type (either Webapp/Mobile app).

String

Header

Accept

optional

Media types acceptable for the response. Default is JSON.

String

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. List of tags is returned.

TagList

400

Bad Request. Invalid request or validation error.

Error

403

Forbidden. The request must be conditional but no condition has been specified.

Error

404

Not Found. The resource to be updated does not exist.

Error