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-eventbridge:amazon-eventbridge-events-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.
A second provider on the same verified email joins the account you already have.
openapi: 3.1.0
info:
title: Amazon EventBridge Events API
version: '2015-10-07'
description: Generated from AWS's published Smithy model for Amazon EventBridge. 1 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://events.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
paths:
/#PutEvents:
post:
operationId: PutEvents
summary: Put Events
description: 'Sends custom events to Amazon EventBridge so that they can be matched to rules. You can batch multiple
event entries into one request for efficiency. However, the total entry size must be less than 1MB. You can calculate
the entry size before you send the events. For more information, see Calculating PutEvents event entry size in the
Amazon EventBridge User Guide . PutEvents accepts the data in JSON format. For the JSON number (integer) data type,
the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807.
PutEvents will only process nested JSON up to 1000 levels deep.'
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/PutEventsResponse'
'500':
description: InternalException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- AWSEvents.PutEvents
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/PutEventsRequest'
tags:
- Events
components:
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: events
schemas:
InternalException:
type: object
properties:
message:
type: string
PutEventsRequest:
type: object
properties:
Entries:
type: array
items:
$ref: '#/components/schemas/PutEventsRequestEntry'
description: The entry that defines an event in your system. You can specify several parameters for the entry such
as the source and type of the event, resources associated with the event, and so on.
EndpointId:
type: string
description: The URL subdomain of the endpoint. For example, if the URL for Endpoint is https://abcde.veo.endpoints.event.amazonaws.com,
then the EndpointId is abcde.veo. When using Java, you must include auth-crt on the class path.
required:
- Entries
PutEventsRequestEntry:
type: object
properties:
Time:
type: string
format: date-time
description: The time stamp of the event, per RFC3339. If no time stamp is provided, the time stamp of the PutEvents
call is used.
Source:
type: string
description: The source of the event. Detail, DetailType, and Source are required for EventBridge to successfully
send an event to an event bus. If you include event entries in a request that do not include each of those properties,
EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties,
EventBridge fails the entire request.
Resources:
type: array
items:
type: string
description: Amazon Web Services resources, identified by Amazon Resource Name (ARN), which the event primarily
concerns. Any number, including zero, may be present.
DetailType:
type: string
description: Free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event
detail. Detail, DetailType, and Source are required for EventBridge to successfully send an event to an event
bus. If you include event entries in a request that do not include each of those properties, EventBridge fails
that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails
the entire request.
Detail:
type: string
description: A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested
sub-objects. Detail, DetailType, and Source are required for EventBridge to successfully send an event to an event
bus. If you include event entries in a request that do not include each of those properties, EventBridge fails
that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails
the entire request.
EventBusName:
type: string
description: The name or ARN of the event bus to receive the event. Only the rules that are associated with this
event bus are used to match the event. If you omit this, the default event bus is used. If you're using a global
endpoint with a custom bus, you can enter either the name or Amazon Resource Name (ARN) of the event bus in either
the primary or secondary Region here. EventBridge then determines the corresponding event bus in the other Region
based on the endpoint referenced by the EndpointId. Specifying the event bus ARN is preferred.
TraceHeader:
type: string
description: An X-Ray trace header, which is an http header (X-Amzn-Trace-Id) that contains the trace-id associated
with the event. To learn more about X-Ray trace headers, see Tracing header in the X-Ray Developer Guide.
PutEventsResponse:
type: object
properties:
FailedEntryCount:
type: integer
description: The number of failed entries.
Entries:
type: array
items:
$ref: '#/components/schemas/PutEventsResultEntry'
description: The successfully and unsuccessfully ingested events results. If the ingestion was successful, the entry
has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the
entry. For each record, the index of the response element is the same as the index in the request array.
PutEventsResultEntry:
type: object
properties:
EventId:
type: string
description: The ID of the event.
ErrorCode:
type: string
description: 'The error code that indicates why the event submission failed. Retryable errors include: InternalFailure
The request processing has failed because of an unknown error, exception or failure. ThrottlingException The request
was denied due to request throttling. Non-retryable errors include: AccessDeniedException You do not have sufficient
access to perform this action. InvalidAccountIdException The account ID provided is not valid. InvalidArgument
A specified parameter is not valid. MalformedDetail The JSON provided is not valid. RedactionFailure Redacting
the CloudTrail event failed. NotAuthori'
ErrorMessage:
type: string
description: The error message that explains why the event submission failed.
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/eventbridge/service/2015-10-07/eventbridge-2015-10-07.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)