Amazon CloudTrail

Amazon CloudTrail Cloudtrail Tag API

The Cloudtrail Tag API from Amazon CloudTrail — 3 operation(s) for cloudtrail tag.

GitHub OpenAPI

Operations 3

POST /#AddTags Add Tags #
POST /#ListTags List Tags #
POST /#RemoveTags Remove Tags #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/amazon-cloudtrail/openapi/amazon-cloudtrail-tag-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/amazon-cloudtrail:amazon-cloudtrail-tag-api"
All apis 
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.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-cloudtrail-tag-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AWS CloudTrail Tag API
  version: '2013-11-01'
  description: Generated from AWS's published Smithy model for AWS CloudTrail. 3 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://cloudtrail.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Tag
paths:
  /#AddTags:
    post:
      operationId: AddTags
      summary: Add Tags
      description: Adds one or more tags to a trail, event data store, dashboard, or channel, up to a limit of 50. Overwrites an existing tag's value when a new value is specified for an existing tag key. Tag key names must be unique; you cannot have two keys with the same name but different values. If you specify a key without a value, the tag will be created with the specified key and a value of null. You can tag a trail or event data store that applies to all Amazon Web Services Regions only from the Region in which the trail or event data store was created (also known as its home Region).
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AddTagsResponse'
        '400':
          description: ChannelARNInvalidException; CloudTrailARNInvalidException; EventDataStoreARNInvalidException; InactiveEventDataStoreException; InvalidTagParameterException; InvalidTrailNameException; NotOrganizationMasterAccountException; OperationNotPermittedException; ResourceNotFoundException; ResourceTypeNotSupportedException; TagsLimitExceededException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ChannelARNInvalidException'
        '404':
          description: ChannelNotFoundException; EventDataStoreNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ChannelNotFoundException'
        '409':
          description: ConflictException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '403':
          description: NoManagementAccountSLRExistsException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/NoManagementAccountSLRExistsException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.AddTags
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/AddTagsRequest'
      tags:
      - Tag
  /#ListTags:
    post:
      operationId: ListTags
      summary: List Tags
      description: Lists the tags for the specified trails, event data stores, dashboards, or channels in the current Region.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ListTagsResponse'
        '400':
          description: ChannelARNInvalidException; CloudTrailARNInvalidException; EventDataStoreARNInvalidException; InactiveEventDataStoreException; InvalidTokenException; InvalidTrailNameException; OperationNotPermittedException; ResourceNotFoundException; ResourceTypeNotSupportedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ChannelARNInvalidException'
        '404':
          description: EventDataStoreNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/EventDataStoreNotFoundException'
        '403':
          description: NoManagementAccountSLRExistsException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/NoManagementAccountSLRExistsException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.ListTags
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/ListTagsRequest'
      tags:
      - Tag
  /#RemoveTags:
    post:
      operationId: RemoveTags
      summary: Remove Tags
      description: Removes the specified tags from a trail, event data store, dashboard, or channel.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RemoveTagsResponse'
        '400':
          description: ChannelARNInvalidException; CloudTrailARNInvalidException; EventDataStoreARNInvalidException; InactiveEventDataStoreException; InvalidTagParameterException; InvalidTrailNameException; NotOrganizationMasterAccountException; OperationNotPermittedException; ResourceNotFoundException; ResourceTypeNotSupportedException; UnsupportedOperationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ChannelARNInvalidException'
        '404':
          description: ChannelNotFoundException; EventDataStoreNotFoundException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ChannelNotFoundException'
        '409':
          description: ConflictException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '403':
          description: NoManagementAccountSLRExistsException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/NoManagementAccountSLRExistsException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - CloudTrail_20131101.RemoveTags
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/RemoveTagsRequest'
      tags:
      - Tag
components:
  schemas:
    EventDataStoreNotFoundException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    ListTagsResponse:
      type: object
      properties:
        ResourceTagList:
          type: array
          items:
            $ref: '#/components/schemas/ResourceTag'
          description: A list of resource tags.
        NextToken:
          type: string
          description: Reserved for future use.
    AddTagsRequest:
      type: object
      properties:
        ResourceId:
          type: string
          description: 'Specifies the ARN of the trail, event data store, dashboard, or channel to which one or more tags will be added. The format of a trail ARN is: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail The format of an event data store ARN is: arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE The format of a dashboard ARN is: arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash The format of a channel ARN is: arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890'
        TagsList:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: Contains a list of tags, up to a limit of 50
      required:
      - ResourceId
      - TagsList
    RemoveTagsRequest:
      type: object
      properties:
        ResourceId:
          type: string
          description: 'Specifies the ARN of the trail, event data store, dashboard, or channel from which tags should be removed. Example trail ARN format: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail Example event data store ARN format: arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE Example dashboard ARN format: arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash Example channel ARN format: arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890'
        TagsList:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: Specifies a list of tags to be removed.
      required:
      - ResourceId
      - TagsList
    RemoveTagsResponse:
      type: object
      properties: {}
    ChannelARNInvalidException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    NoManagementAccountSLRExistsException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    ListTagsRequest:
      type: object
      properties:
        ResourceIdList:
          type: array
          items:
            type: string
          description: 'Specifies a list of trail, event data store, dashboard, or channel ARNs whose tags will be listed. The list has a limit of 20 ARNs. Example trail ARN format: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail Example event data store ARN format: arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE Example dashboard ARN format: arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash Example channel ARN format: arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890'
        NextToken:
          type: string
          description: Reserved for future use.
      required:
      - ResourceIdList
    ChannelNotFoundException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    Tag:
      type: object
      properties:
        Key:
          type: string
          description: The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.
        Value:
          type: string
          description: The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.
      required:
      - Key
    ResourceTag:
      type: object
      properties:
        ResourceId:
          type: string
          description: Specifies the ARN of the resource.
        TagsList:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: A list of tags.
    ConflictException:
      type: object
      properties:
        Message:
          type: string
          description: Brief description of the exception returned by the request.
    AddTagsResponse:
      type: object
      properties: {}
  securitySchemes:
    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: cloudtrail
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudtrail/service/2013-11-01/cloudtrail-2013-11-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)