AWS CloudTrail
CloudTrail This is the CloudTrail API Reference. It provides descriptions of actions, data types, common parameters, and common errors for CloudTrail.…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
CloudTrail
This is the CloudTrail API Reference. It provides descriptions of actions, data
types, common parameters, and common errors for CloudTrail.
CloudTrail is a web service that records Amazon Web Services API calls for your
Amazon Web Services account and delivers log files to an Amazon S3 bucket. The
recorded information includes the identity of the user, the start time of the Amazon Web Services API call, the source IP address, the request parameters, and the response
elements returned by the service.
As an alternative to the API, you can use one of the Amazon Web Services SDKs, which
consist of libraries and sample code for various programming languages and platforms
(Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide programmatic access to CloudTrail. For example, the SDKs handle cryptographically signing requests,
managing errors, and retrying requests automatically. For more information about the
Amazon Web Services SDKs, including how to download and install them, see Tools to Build on Amazon Web Services .
See the CloudTrail
User Guide for information about the data that is included with each Amazon Web Services API call listed in the log files.
Endpoints 60
- POSTAdd tags
/#X-Amz-Target=CloudTrail_20131101.AddTagsAdds 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… - POSTCancel query
/#X-Amz-Target=CloudTrail_20131101.CancelQueryCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTCreate channel
/#X-Amz-Target=CloudTrail_20131101.CreateChannelCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTCreate dashboard
/#X-Amz-Target=CloudTrail_20131101.CreateDashboardCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTCreate event data store
/#X-Amz-Target=CloudTrail_20131101.CreateEventDataStoreCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTCreate trail
/#X-Amz-Target=CloudTrail_20131101.CreateTrailCreates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket. - POSTDelete channel
/#X-Amz-Target=CloudTrail_20131101.DeleteChannelCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTDelete dashboard
/#X-Amz-Target=CloudTrail_20131101.DeleteDashboardCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTDelete event data store
/#X-Amz-Target=CloudTrail_20131101.DeleteEventDataStoreCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTDelete resource policy
/#X-Amz-Target=CloudTrail_20131101.DeleteResourcePolicyDeletes the resource-based policy attached to the CloudTrail event data store, dashboard, or channel. - POSTDelete trail
/#X-Amz-Target=CloudTrail_20131101.DeleteTrailDeletes a trail. This operation must be called from the Region in which the trail was created. DeleteTrail cannot be called on the shadow trails (replicated… - POSTDeregister organization delegated admin
/#X-Amz-Target=CloudTrail_20131101.DeregisterOrganizationDelegatedAdminRemoves CloudTrail delegated administrator permissions from a member account in an organization. - POSTDescribe query
/#X-Amz-Target=CloudTrail_20131101.DescribeQueryCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTDescribe trails
/#X-Amz-Target=CloudTrail_20131101.DescribeTrailsRetrieves settings for one or more trails associated with the current Region for your account. - POSTDisable federation
/#X-Amz-Target=CloudTrail_20131101.DisableFederationCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTEnable federation
/#X-Amz-Target=CloudTrail_20131101.EnableFederationCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGenerate query
/#X-Amz-Target=CloudTrail_20131101.GenerateQueryCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet channel
/#X-Amz-Target=CloudTrail_20131101.GetChannelCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet dashboard
/#X-Amz-Target=CloudTrail_20131101.GetDashboardCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet event configuration
/#X-Amz-Target=CloudTrail_20131101.GetEventConfigurationRetrieves the current event configuration settings for the specified event data store or trail. The response includes maximum event size configuration, the… - POSTGet event data store
/#X-Amz-Target=CloudTrail_20131101.GetEventDataStoreCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet event selectors
/#X-Amz-Target=CloudTrail_20131101.GetEventSelectorsDescribes the settings for the event selectors that you configured for your trail. The information returned for your event selectors includes the following:… - POSTGet import
/#X-Amz-Target=CloudTrail_20131101.GetImportCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet insight selectors
/#X-Amz-Target=CloudTrail_20131101.GetInsightSelectorsDescribes the settings for the Insights event selectors that you configured for your trail or event data store. GetInsightSelectors shows if CloudTrail… - POSTGet query results
/#X-Amz-Target=CloudTrail_20131101.GetQueryResultsCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTGet resource policy
/#X-Amz-Target=CloudTrail_20131101.GetResourcePolicyRetrieves the JSON text of the resource-based policy document attached to the CloudTrail event data store, dashboard, or channel. - POSTGet trail
/#X-Amz-Target=CloudTrail_20131101.GetTrailReturns settings information for a specified trail. - POSTGet trail status
/#X-Amz-Target=CloudTrail_20131101.GetTrailStatusReturns a JSON-formatted list of information about the specified trail. Fields include information on delivery errors, Amazon SNS and Amazon S3 errors, and… - POSTList channels
/#X-Amz-Target=CloudTrail_20131101.ListChannelsCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList dashboards
/#X-Amz-Target=CloudTrail_20131101.ListDashboardsCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList event data stores
/#X-Amz-Target=CloudTrail_20131101.ListEventDataStoresCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList import failures
/#X-Amz-Target=CloudTrail_20131101.ListImportFailuresCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList imports
/#X-Amz-Target=CloudTrail_20131101.ListImportsCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList insights data
/#X-Amz-Target=CloudTrail_20131101.ListInsightsDataReturns Insights events generated on a trail that logs data events. You can list Insights events that occurred in a Region within the last 90 days.… - POSTList insights metric data
/#X-Amz-Target=CloudTrail_20131101.ListInsightsMetricDataReturns Insights metrics data for trails that have enabled Insights. The request must include the EventSource , EventName , and InsightType parameters. If the… - POSTList public keys
/#X-Amz-Target=CloudTrail_20131101.ListPublicKeysReturns all public keys whose private keys were used to sign the digest files within the specified time range. The public key is needed to validate digest… - POSTList queries
/#X-Amz-Target=CloudTrail_20131101.ListQueriesCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTList tags
/#X-Amz-Target=CloudTrail_20131101.ListTagsLists the tags for the specified trails, event data stores, dashboards, or channels in the current Region. - POSTList trails
/#X-Amz-Target=CloudTrail_20131101.ListTrailsLists trails that are in the current account. - POSTLookup events
/#X-Amz-Target=CloudTrail_20131101.LookupEventsLooks up management events or CloudTrail Insights events that are captured by CloudTrail. You can look up events that occurred in a Region within the last 90… - POSTPut event configuration
/#X-Amz-Target=CloudTrail_20131101.PutEventConfigurationUpdates the event configuration settings for the specified event data store or trail. This operation supports updating the maximum event size, adding or… - POSTPut event selectors
/#X-Amz-Target=CloudTrail_20131101.PutEventSelectorsConfigures event selectors (also referred to as basic event selectors ) or advanced event selectors for your trail. You can use either AdvancedEventSelectors… - POSTPut insight selectors
/#X-Amz-Target=CloudTrail_20131101.PutInsightSelectorsLets you enable Insights event logging on specific event categories by specifying the Insights selectors that you want to enable on an existing trail or event… - POSTPut resource policy
/#X-Amz-Target=CloudTrail_20131101.PutResourcePolicyAttaches a resource-based permission policy to a CloudTrail event data store, dashboard, or channel. For more information about resource-based policies, see… - POSTRegister organization delegated admin
/#X-Amz-Target=CloudTrail_20131101.RegisterOrganizationDelegatedAdminRegisters an organization’s member account as the CloudTrail delegated administrator . - POSTRemove tags
/#X-Amz-Target=CloudTrail_20131101.RemoveTagsRemoves the specified tags from a trail, event data store, dashboard, or channel. - POSTRestore event data store
/#X-Amz-Target=CloudTrail_20131101.RestoreEventDataStoreCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTSearch sample queries
/#X-Amz-Target=CloudTrail_20131101.SearchSampleQueriesCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStart dashboard refresh
/#X-Amz-Target=CloudTrail_20131101.StartDashboardRefreshCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStart event data store ingestion
/#X-Amz-Target=CloudTrail_20131101.StartEventDataStoreIngestionCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStart import
/#X-Amz-Target=CloudTrail_20131101.StartImportCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStart logging
/#X-Amz-Target=CloudTrail_20131101.StartLoggingStarts the recording of Amazon Web Services API calls and log file delivery for a trail. For a trail that is enabled in all Regions, this operation must be… - POSTStart query
/#X-Amz-Target=CloudTrail_20131101.StartQueryCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStop event data store ingestion
/#X-Amz-Target=CloudTrail_20131101.StopEventDataStoreIngestionCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStop import
/#X-Amz-Target=CloudTrail_20131101.StopImportCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTStop logging
/#X-Amz-Target=CloudTrail_20131101.StopLoggingSuspends the recording of Amazon Web Services API calls and log file delivery for the specified trail. Under most circumstances, there is no need to use this… - POSTUpdate channel
/#X-Amz-Target=CloudTrail_20131101.UpdateChannelCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTUpdate dashboard
/#X-Amz-Target=CloudTrail_20131101.UpdateDashboardCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTUpdate event data store
/#X-Amz-Target=CloudTrail_20131101.UpdateEventDataStoreCloudTrail Lake will no longer be open to new customers starting May 31, 2026. If you would like to use CloudTrail Lake, sign up prior to that date. Existing… - POSTUpdate trail
/#X-Amz-Target=CloudTrail_20131101.UpdateTrailUpdates trail settings that control what events you are logging, and how to handle log files. Changes to a trail do not require stopping the CloudTrail…
API details
- Base URL
https://cloudtrail.{region}.amazonaws.com- Authentication
- AWS Signature Version 4 (requests signed with your AWS access key)
- Operations
- 60 operations on 60 pathsPOST 60
- Description format
- AWS Smithy model, API version
2013-11-01 - Links
- Documentation · OpenAPI document
- Listed from
- AWS Smithy API model (aws/api-models-aws) (Apache-2.0)
How to test the AWS CloudTrail in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AWS CloudTrail collection, without the publisher's secrets.
- Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Add tags” (POST /#X-Amz-Target=CloudTrail_20131101.AddTags), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AWS CloudTrail?
CloudTrail This is the CloudTrail API Reference. It provides descriptions of actions, data types, common parameters, and common errors for CloudTrail.… It is listed under Developer tools and has 60 endpoints.
Who publishes the AWS CloudTrail?
It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.
What is the base URL of the AWS CloudTrail?
Requests go to https://cloudtrail.{region}.amazonaws.com. Endpoint paths are added to this base URL.
How do I authenticate with the AWS CloudTrail?
With AWS Signature Version 4 (requests signed with your AWS access key).
How many endpoints does the AWS CloudTrail have?
60 operations on 60 paths (60 POST).
Is forking the AWS CloudTrail free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.