How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon EventBridge Pipes Pipes API

The Pipes API from Amazon EventBridge Pipes — 4 operation(s) for pipes.

Amazon EventBridge Pipes Pipes API is one of 2 APIs that Amazon EventBridge Pipes publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Pipes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, pricing, a JSON-LD context, and 3 JSON Schemas.

This API exposes 7 operations across 4 paths, and defines 176 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://pipes.{region}.amazonaws.com, https://pipes.{region}.amazonaws.com, http://pipes.{region}.amazonaws.com.cn, https://pipes.{region}.amazonaws.com.cn.

7 operations 4 paths 176 schemas 1 DELETE2 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://pipes.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon EventBridge Pipes Pipes API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Pipes 7
POST
/v1/pipes/{Name}
Amazon EventBridge Pipes CreatePipe
CreatePipe 8 params body → 200480481482483484485
DELETE
/v1/pipes/{Name}
Amazon EventBridge Pipes DeletePipe
DeletePipe 8 params → 200480481482483484
GET
/v1/pipes/{Name}
Amazon EventBridge Pipes DescribePipe
DescribePipe 8 params → 200480481482483
PUT
/v1/pipes/{Name}
Amazon EventBridge Pipes UpdatePipe
UpdatePipe 8 params body → 200480481482483484
GET
/v1/pipes
Amazon EventBridge Pipes ListPipes
ListPipes 14 params → 200480481482
POST
/v1/pipes/{Name}/start
Amazon EventBridge Pipes StartPipe
StartPipe 8 params → 200480481482483484
POST
/v1/pipes/{Name}/stop
Amazon EventBridge Pipes StopPipe
StopPipe 8 params → 200480481482483484

Schemas 176

The contract defines 176 schemas that model the data the API accepts and returns. The most detailed are DescribePipeResponse (16 properties), PipeTargetEcsTaskParameters (15 properties), PipeTargetParameters (12 properties), Pipe (10 properties). Each schema is shown below with its type and property counts.

PipeTargetEventBridgeEventBusParameters
object
The parameters for using an EventBridge event bus as a target.
5 properties
PlacementStrategyField
string
UpdatePipeSourceRabbitMQBrokerParameters
object
The parameters for using a Rabbit MQ broker as a source.
3 properties 1 required
BatchParametersMap
object
MQBrokerQueueName
string
ServiceQuotaExceededException
PipeSourceDynamoDBStreamParameters
object
The parameters for using a DynamoDB stream as a source.
8 properties 1 required
CapacityProviderStrategyItemBase
integer
ArnOrUrl
string
BatchEnvironmentVariable
object
The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the…
2 properties
UpdatePipeSourceManagedStreamingKafkaParameters
object
The parameters for using an MSK stream as a source.
3 properties
DeletePipeResponse
object
6 properties
EcsEnvironmentFileType
string
CapacityProviderStrategyItemWeight
integer
EcsResourceRequirementsList
array
ConflictException
PipeSourceKinesisStreamParameters
object
The parameters for using a Kinesis stream as a source.
9 properties 1 required
UpdatePipeSourceActiveMQBrokerParameters
object
The parameters for using an Active MQ broker as a source.
3 properties 1 required
ReferenceId
string
MaximumRecordAgeInSeconds
integer
UpdatePipeSourceDynamoDBStreamParameters
object
The parameters for using a DynamoDB stream as a source.
7 properties
EcsInferenceAcceleratorOverrideList
array
SecretManagerArnOrJsonPath
string
// For targets, can either specify an ARN or a jsonpath pointing to the ARN.
PipeEnrichmentHttpParameters
object
These are custom parameter to be used when the target is an API Gateway REST APIs or EventBridge ApiDestinations. In the latter case, these are merged with any…
3 properties
PipeStateReason
string
PipeTargetEcsTaskParameters
object
The parameters for using an Amazon ECS task as a target.
15 properties 1 required
BatchResourceRequirementType
string
UpdatePipeSourceSqsQueueParameters
object
The parameters for using a Amazon SQS stream as a source.
2 properties
UpdatePipeSourceKinesisStreamParameters
object
The parameters for using a Kinesis stream as a source.
7 properties
PipeSourceParameters
object
The parameters required to set up a source for your pipe.
8 properties
PipeTargetBatchJobParameters
object
The parameters for using an Batch job as a target.
7 properties 2 required
TagList
array
LimitMax10
integer
EcsEphemeralStorage
object
The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default…
1 property 1 required
PipeList
array
InternalException
StopPipeResponse
object
6 properties
Subnets
array
TagValue
string
StartPipeResponse
object
6 properties
AwsVpcConfiguration
object
This structure specifies the VPC subnets and security groups for the task, and whether a public IP address is to be used. This structure is relevant only for E…
3 properties 1 required
BatchContainerOverrides
object
The overrides that are sent to a container.
4 properties
Sqls
array
// A list of SQLs.
UpdatePipeResponse
object
6 properties
AssignPublicIp
string
LogStreamName
string
RequestedPipeState
string
PipeTargetHttpParameters
object
These are custom parameter to be used when the target is an API Gateway REST APIs or EventBridge ApiDestinations.
3 properties
BatchArrayProperties
object
The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a jo…
1 property
PathParameter
string
SageMakerPipelineParameter
object
Name/Value pair of a parameter to start execution of a SageMaker Model Building Pipeline.
2 properties 2 required
PlacementStrategyType
string
MaximumRetryAttemptsESM
integer
SelfManagedKafkaAccessConfigurationVpc
object
This structure specifies the VPC subnets and security groups for the stream, and whether a public IP address is to be used.
2 properties
StringList
array
PlacementStrategies
array
SecurityGroups
array
SecurityGroupId
string
PlacementConstraintExpression
string
TagKey
string
PlacementConstraints
array
CapacityProviderStrategyItem
object
The details of a capacity provider strategy. To learn more, see CapacityProviderStrategyItem in the Amazon ECS API Reference.
3 properties 1 required
PropagateTags
string
DbUser
string
// Database user name
SubnetId
string
EphemeralStorageSize
integer
EcsEnvironmentVariable
object
The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the…
2 properties
PipeTargetSageMakerPipelineParameters
object
The parameters for using a SageMaker pipeline as a target.
1 property
KinesisPartitionKey
string
BatchResourceRequirement
object
The type and amount of a resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .
2 properties 2 required
OptionalArn
string
OnPartialBatchItemFailureStreams
string
BatchJobDependencyType
string
Subnet
string
MSKAccessCredentials
object
The Secrets Manager secret that stores your stream credentials.
2 properties
NextToken
string
PipeTargetRedshiftDataParameters
object
These are custom parameters to be used when the target is a Amazon Redshift cluster to invoke the Amazon Redshift Data API ExecuteStatement.
6 properties 2 required
URI
string
Timestamp
string
SecurityGroup
string
KafkaBootstrapServers
array
EcsEnvironmentVariableList
array
ArnOrJsonPath
string
UpdatePipeSourceSelfManagedKafkaParameters
object
The parameters for using a self-managed Apache Kafka stream as a source.
5 properties
QueryStringValue
string
MQBrokerAccessCredentials
object
The Secrets Manager secret that stores your broker credentials.
1 property
DescribePipeResponse
object
16 properties
KinesisStreamStartPosition
string
MessageGroupId
string
PipeTargetCloudWatchLogsParameters
object
The parameters for using an CloudWatch Logs log stream as a target.
2 properties
LimitMax10000
integer
Tag
object
A key-value pair associated with an Amazon Web Services resource. In EventBridge, rules and event buses support tagging.
2 properties 2 required
SecurityGroupIds
array
List of SecurityGroupId.
PipeEnrichmentParameters
object
The parameters required to set up enrichment on your pipe.
2 properties
KafkaTopicName
string
PipeSourceActiveMQBrokerParameters
object
The parameters for using an Active MQ broker as a source.
4 properties 2 required
RoleArn
string
SelfManagedKafkaAccessConfigurationCredentials
object
The Secrets Manager secret that stores your stream credentials.
4 properties
EcsContainerOverride
object
The overrides that are sent to a container. An empty container override can be passed in. An example of an empty container override is {"containerOverrides": […
8 properties
EventBridgeEventResourceList
array
Integer
integer
PipeTargetStateMachineParameters
object
The parameters for using a Step Functions state machine as a target.
1 property
MSKStartPosition
string
PathParameterList
array
FilterCriteria
object
The collection of event patterns used to filter events. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide .
1 property
PipeArn
string
CapacityProviderStrategy
array
ThrottlingException
JsonPath
string
EventBridgeDetailType
string
RequestedPipeStateDescribeResponse
string
CreatePipeResponse
object
6 properties
HeaderValue
string
PipeTargetLambdaFunctionParameters
object
The parameters for using a Lambda function as a target.
1 property
MessageDeduplicationId
string
PipeTargetInvocationType
string
PipeDescription
string
MaximumBatchingWindowInSeconds
integer
SecretManagerArn
string
// Optional SecretManager ARN which stores the database credentials
PipeSourceSelfManagedKafkaParameters
object
The parameters for using a self-managed Apache Kafka stream as a source.
9 properties 1 required
NotFoundException
EcsEnvironmentFileList
array
PipeTargetKinesisStreamParameters
object
The parameters for using a Kinesis stream as a source.
1 property 1 required
PipeSourceManagedStreamingKafkaParameters
object
The parameters for using an MSK stream as a source.
6 properties 1 required
SelfManagedKafkaStartPosition
string
EcsTaskOverride
object
The overrides that are associated with a task.
7 properties
ListPipesResponse
object
2 properties
BatchRetryAttempts
integer
DynamoDBStreamStartPosition
string
Pipe
object
An object that represents a pipe. Amazon EventBridgePipes connect event sources to targets and reduces the need for specialized knowledge and integration code.
10 properties
BatchEnvironmentVariableList
array
PlacementConstraint
object
An object representing a constraint on task placement. To learn more, see Task Placement Constraints in the Amazon Elastic Container Service Developer Guide.
2 properties
EcsContainerOverrideList
array
ValidationException
Boolean
boolean
EventPattern
string
StatementName
string
// A name for Redshift DataAPI statement which can be used as filter of // ListStatement.
EcsInferenceAcceleratorOverride
object
Details on an Elastic Inference accelerator task override. This parameter is used to override the Elastic Inference accelerator specified in the task definitio…
2 properties
BatchRetryStrategy
object
The retry strategy that's associated with a job. For more information, see Automated job retries in the Batch User Guide .
1 property
SubnetIds
array
List of SubnetId.
PipeState
string
Database
string
// Redshift Database
EventBridgeEndpointId
string
LaunchType
string
SageMakerPipelineParameterValue
string
Arn
string
NetworkConfiguration
object
This structure specifies the network configuration for an Amazon ECS task.
1 property
EcsResourceRequirement
object
The type and amount of a resource to assign to a container. The supported resource types are GPUs and Elastic Inference accelerators. For more information, see…
2 properties 2 required
PipeTargetSqsQueueParameters
object
The parameters for using a Amazon SQS stream as a source.
2 properties
EndpointString
string
EcsResourceRequirementType
string
EcsEnvironmentFile
object
A list of files containing the environment variables to pass to a container. You can specify up to ten environment files. The file must have a .env file extens…
2 properties 2 required
DeadLetterConfig
object
A DeadLetterConfig object that contains information about a dead-letter queue configuration.
1 property
BatchArraySize
integer
BatchDependsOn
array
String
string
LimitMin1
integer
BatchJobDependency
object
An object that represents an Batch job dependency.
2 properties
CapacityProvider
string
QueryStringParametersMap
object
FilterList
array
BatchResourceRequirementsList
array
Sql
string
// A single Redshift SQL
PipeSourceRabbitMQBrokerParameters
object
The parameters for using a Rabbit MQ broker as a source.
5 properties 2 required
PipeTargetParameters
object
The parameters required to set up a target for your pipe.
12 properties
SageMakerPipelineParameterName
string
TagMap
object
PipeSourceSqsQueueParameters
object
The parameters for using a Amazon SQS stream as a source.
2 properties
InputTemplate
string
SageMakerPipelineParameterList
array
PipeName
string
PlacementConstraintType
string
PlacementStrategy
object
The task placement strategy for a task or service. To learn more, see Task Placement Strategies in the Amazon Elastic Container Service Service Developer Guide.
2 properties
HeaderParametersMap
object
EventBridgeEventSource
string
Filter
object
Filter events using an event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide .
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-eventbridge-pipes-pipes-api-openapi.yml Raw ↑

Other APIs Amazon EventBridge Pipes publishes across the network.

Amazon EventBridge Pipes Tags API
Where this information came from

This is an independent, third-party profile of Amazon EventBridge Pipes Pipes API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.