The Tags API from Amazon WorkSpaces Web — 2 operation(s) for tags.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/amazon-workspaces-web:amazon-workspaces-web-tags-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Amazon Workspaces Web Tags API
version: '2020-07-08'
x-refined-note:
- x-apiClientRegistration differs across the merged source definitions and was not carried
- x-apisguru-categories differs across the merged source definitions and was not carried
- x-aws-signingName differs across the merged source definitions and was not carried
- x-logo differs across the merged source definitions and was not carried
- x-origin differs across the merged source definitions and was not carried
- x-preferred differs across the merged source definitions and was not carried
- x-providerName differs across the merged source definitions and was not carried
- x-release differs across the merged source definitions and was not carried
- x-serviceName differs across the merged source definitions and was not carried
description: 'Operations tagged Tags across 2 of this provider''s published API definitions: amazon-workspaces-web-openapi-original.yaml, amazon-workspaces-web-tags-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: http://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: https://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: http://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
- url: https://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
tags:
- name: Tags
paths:
/tags/{resourceArn}:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
get:
operationId: ListTagsForResource
description: Retrieves a list of tags for a resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListTagsForResourceResponse'
'480':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'481':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'483':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
parameters:
- name: resourceArn
in: path
required: true
description: The ARN of the resource.
schema:
type: string
pattern: ^arn:[\w+=\/,.@-]+:[a-zA-Z0-9\-]+:[a-zA-Z0-9\-]*:[a-zA-Z0-9]{1,12}:[a-zA-Z]+(\/[a-fA-F0-9\-]{36})+$
minLength: 20
maxLength: 2048
summary: Amazon WorkSpaces Web List Tags for Resource
tags:
- Tags
security:
- hmac: []
post:
operationId: TagResource
description: Adds or overwrites one or more tags for the specified resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/TagResourceResponse'
'480':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'481':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'483':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'485':
description: TooManyTagsException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyTagsException'
parameters:
- name: resourceArn
in: path
required: true
description: The ARN of the resource.
schema:
type: string
pattern: ^arn:[\w+=\/,.@-]+:[a-zA-Z0-9\-]+:[a-zA-Z0-9\-]*:[a-zA-Z0-9]{1,12}:[a-zA-Z]+(\/[a-fA-F0-9\-]{36})+$
minLength: 20
maxLength: 2048
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- tags
properties:
clientToken:
description: <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token returns the result from the original successful request. </p> <p>If you do not specify a client token, one is automatically generated by the AWS SDK.</p>
type: string
minLength: 1
maxLength: 512
tags:
description: The tags of the resource.
type: array
items:
$ref: '#/components/schemas/Tag'
minItems: 0
maxItems: 200
summary: Amazon WorkSpaces Web Tag Resource
tags:
- Tags
security:
- hmac: []
servers:
- url: http://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: https://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: http://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
- url: https://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
/tags/{resourceArn}#tagKeys:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
delete:
operationId: UntagResource
description: Removes one or more tags from the specified resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UntagResourceResponse'
'480':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'481':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'483':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
parameters:
- name: resourceArn
in: path
required: true
description: The ARN of the resource.
schema:
type: string
pattern: ^arn:[\w+=\/,.@-]+:[a-zA-Z0-9\-]+:[a-zA-Z0-9\-]*:[a-zA-Z0-9]{1,12}:[a-zA-Z]+(\/[a-fA-F0-9\-]{36})+$
minLength: 20
maxLength: 2048
- name: tagKeys
in: query
required: true
description: The list of tag keys to remove from the resource.
schema:
type: array
items:
$ref: '#/components/schemas/TagKey'
minItems: 0
maxItems: 200
summary: Amazon WorkSpaces Web Untag Resource
tags:
- Tags
security:
- hmac: []
servers:
- url: http://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: https://workspaces-web.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The Amazon WorkSpaces Web multi-region endpoint
- url: http://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
- url: https://workspaces-web.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The Amazon WorkSpaces Web endpoint for China (Beijing) and China (Ningxia)
/tags/{resourceArn+}:
get:
operationId: getTagsByResourceArn+
summary: List Tags For Resource
description: Retrieves a list of tags for a resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListTagsForResourceResponse_2'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException_2'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException_2'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException_2'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException_2'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException_2'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListTagsForResourceRequest'
tags:
- Tags
security:
- sigv4: []
x-operation-id-source: normalized
x-operation-id-original: ListTagsForResource
post:
operationId: postTagsByResourceArn+
summary: Tag Resource
description: Adds or overwrites one or more tags for the specified resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/TagResourceResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException_2'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException_2'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException_2'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException_2'
'400':
description: TooManyTagsException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyTagsException_2'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TagResourceRequest'
tags:
- Tags
security:
- sigv4: []
x-operation-id-source: normalized
x-operation-id-original: TagResource
delete:
operationId: deleteTagsByResourceArn+
summary: Untag Resource
description: Removes one or more tags from the specified resource.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UntagResourceResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException_2'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException_2'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException_2'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException_2'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException_2'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UntagResourceRequest'
tags:
- Tags
security:
- sigv4: []
x-operation-id-source: normalized
x-operation-id-original: UntagResource
servers:
- url: https://workspaces-web.{region}.amazonaws.com
variables:
region:
default: us-east-1
components:
parameters:
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
schemas:
ListTagsForResourceResponse:
type: object
properties:
tags:
allOf:
- $ref: '#/components/schemas/TagList'
- description: The tags of the resource.
InternalServerException: {}
UntagResourceResponse:
type: object
properties: {}
TooManyTagsException: {}
AccessDeniedException: {}
TagList:
type: array
items:
$ref: '#/components/schemas/Tag'
minItems: 0
maxItems: 200
Tag:
type: object
required:
- Key
- Value
properties:
Key:
allOf:
- $ref: '#/components/schemas/TagKey'
- description: The key of the tag.
Value:
allOf:
- $ref: '#/components/schemas/TagValue'
- description: The value of the tag
description: The tag.
TagKey:
type: string
pattern: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
minLength: 1
maxLength: 128
format: password
ValidationException: {}
TagResourceResponse:
type: object
properties: {}
ThrottlingException: {}
TagValue:
type: string
pattern: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
minLength: 0
maxLength: 256
format: password
ResourceNotFoundException: {}
AccessDeniedException_2:
type: object
properties:
message:
type: string
ValidationExceptionField:
type: object
properties:
name:
type: string
description: The name of the field that failed validation.
message:
type: string
description: The message describing why the field failed validation.
required:
- name
- message
ListTagsForResourceRequest:
type: object
properties:
resourceArn:
type: string
description: The ARN of the resource.
required:
- resourceArn
Tag_2:
type: object
properties:
Key:
type: string
description: The key of the tag.
Value:
type: string
description: The value of the tag
required:
- Key
- Value
ThrottlingException_2:
type: object
properties:
message:
type: string
serviceCode:
type: string
description: The originating service.
quotaCode:
type: string
description: The originating quota.
retryAfterSeconds:
type: integer
description: Advice to clients on when the call can be safely retried.
UntagResourceRequest:
type: object
properties:
resourceArn:
type: string
description: The ARN of the resource.
tagKeys:
type: array
items:
type: string
description: The list of tag keys to remove from the resource.
required:
- resourceArn
- tagKeys
TooManyTagsException_2:
type: object
properties:
message:
type: string
resourceName:
type: string
description: Name of the resource affected.
ListTagsForResourceResponse_2:
type: object
properties:
tags:
type: array
items:
$ref: '#/components/schemas/Tag_2'
description: The tags of the resource.
TagResourceRequest:
type: object
properties:
resourceArn:
type: string
description: The ARN of the resource.
tags:
type: array
items:
$ref: '#/components/schemas/Tag_2'
description: The tags of the resource.
clientToken:
type: string
description: A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token returns the result from the original successful request. If you do not specify a client token, one is automatically generated by the Amazon Web Services SDK.
required:
- resourceArn
- tags
InternalServerException_2:
type: object
properties:
message:
type: string
retryAfterSeconds:
type: integer
description: Advice to clients on when the call can be safely retried.
ValidationException_2:
type: object
properties:
message:
type: string
reason:
type: string
description: Reason the request failed validation
fieldList:
type: array
items:
$ref: '#/components/schemas/ValidationExceptionField'
description: The field that caused the error.
ResourceNotFoundException_2:
type: object
properties:
message:
type: string
resourceId:
type: string
description: Hypothetical identifier of the resource affected.
resourceType:
type: string
description: Hypothetical type of the resource affected.
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: workspaces-web
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/workspaces-web/
x-refined-from:
- amazon-workspaces-web-openapi-original.yaml
- amazon-workspaces-web-tags-api-openapi.yml
x-hasEquivalentPaths: true