Static
createStatic
createCreate an Event API Version
Use this API to create an event API version.
Token Permissions: [ event_api:update:*
]
EventApiVersionResponse Created an event API version. Returns the newly saved event API version in the response body.
ApiError
Event API version. *
Optional
xOptional context id the request is running. *
Static
createCreate an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to create an event API version.
EventApiVersionResponse Created an event API version. Returns the newly saved event API version in the response body.
ApiError
The ID of the parent event API. *
Event API version. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Event API
Use this API to delete an event API.
Token Permissions: [ event_api:delete:*
]
void
ApiError
The ID of the event API. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Event API Version
Use this API to delete an event API version by event API version ID.
Token Permissions: [ event_api:update:*
]
void
ApiError
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to delete an event API version.
void
ApiError
The ID of the parent event API. *
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
getGet the AsyncAPI Specification for an Event API Version
Use this API to get the AsyncAPI specification for an event API version annotated with Event Portal metadata.
Token Permissions: [ event_api:generate_async_api:*
]
string The AsyncAPI specification for the event API version.
ApiError
Optional
asyncThe version of AsyncAPI to use. *
Optional
eventThe ID of the event API Product Version to use for generating bindings. *
The ID of the event API version. *
Optional
format?: "json" | "yaml"The format in which to get the AsyncAPI specification. Possible values are yaml and json. *
Optional
gatewayThe list IDs of gateway messaging services for generating bindings. *
Optional
includedThe event portal database keys to include for each AsyncAPI object. *
Optional
planThe ID of the plan to use for generating bindings. *
Optional
showInclude versions in each AsyncAPI object's name when only one version is present *
Optional
xOptional context id the request is running. *
Static
getGet an Event API
Use this API to get a single event API by its ID.
Token Permissions: [ event_api:get:*
]
EventApiResponse The event API.
ApiError
The ID of the event API. *
Optional
xOptional context id the request is running. *
Static
getGet an Event API Version
Use this API to get a single event API version by its ID.
Token Permissions: [ event_api:get:*
]
EventApiVersionResponse The event API version.
ApiError
Optional
include?: stringA list of additional entities to include in the response. *
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
getGet the AsyncAPI Specification for an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to get the AsyncAPI specification for an event API version using the parent ID and the version's ID.
string The AsyncAPI specification for the event API version.
ApiError
The ID of the parent event API. *
Optional
eventThe ID of the event API Product Version to use for generating bindings. *
Optional
format?: "json" | "yaml"The format in which to get the AsyncAPI specification. Possible values are yaml and json. *
Optional
gatewayThe list IDs of gateway messaging services for generating bindings. *
The ID of the event API version. *
Optional
includedThe event portal database keys to include for each AsyncAPI object. *
Optional
planThe ID of the plan to use for generating bindings. *
Optional
showInclude versions in each AsyncAPI object's name when only one version is present. *
Optional
version?: "2.0.0" | "2.2.0" | "2.5.0"The version of AsyncAPI to use. *
Optional
xOptional context id the request is running. *
Static
getGet an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to get a single event API version using the parent ID and the version's ID.
EventApiVersionResponse The event API version.
ApiError
The ID of the parent event API. *
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
getGet a List of Event API Versions
Use this API to get a list of event API versions that match the given parameters.
Token Permissions: [ event_designer:access
]
EventApiVersionsResponse Get a list of event API versions.
ApiError
Optional
customReturns the entities that match the custom attribute filter.
To filter by custom attribute name and value, use the format: customAttributes=<custom-attribute-name>==<custom-attribute-value>
.
To filter by custom attribute name, use the format: customAttributes=<custom-attribute-name>
.
The filter supports the AND
operator for multiple custom attribute definitions (not multiple values for a given definition). Use ;
(semicolon
) to separate multiple queries with AND
operation.
Note: the filter supports custom attribute values containing only the characters [a-zA-Z0-9_\-\. ]
. *
Optional
eventMatch only event API versions of these event API IDs, separated by commas. *
Optional
ids?: string[]Match event API versions with the given IDs, separated by commas. *
Optional
include?: stringA list of additional entities to include in the response. *
Optional
pageThe page number to get results from based on the page size. *
Optional
pageThe number of results to return in one page of results. *
Optional
stateMatch event API versions with the given state ID. *
Optional
xOptional context id the request is running. *
Static
getGet a List of Event API Versions
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to get a list of event API versions under a particular event API matching the given parameters.
EventApiVersionsResponse Get a list of event API versions.
ApiError
Optional
customReturns the entities that match the custom attribute filter.
To filter by custom attribute name and value, use the format: customAttributes=<custom-attribute-name>==<custom-attribute-value>
.
To filter by custom attribute name, use the format: customAttributes=<custom-attribute-name>
.
The filter supports the AND
operator for multiple custom attribute definitions (not multiple values for a given definition). Use ;
(semicolon
) to separate multiple queries with AND
operation.
Note: the filter supports custom attribute values containing only the characters [a-zA-Z0-9_\-\. ]
. *
Optional
displayMatch event API versions with the given display name. *
The ID of the parent event API. *
The ID of the event API version. *
Optional
ids?: string[]Match event API versions with the given IDs separated by commas. *
Optional
stateMatch event API versions with the given state ID. *
Optional
version?: stringMatch event API versions with the given version. *
Optional
xOptional context id the request is running. *
Static
getGet a List of Event APIs
Use this API to get a list of event APIs that match the given parameters.
Token Permissions: [ event_designer:access
]
EventApisResponse Get a list of event APIs and the accompanying metadata.
ApiError
Optional
applicationMatch only event APIs in the given application domain. *
Optional
applicationMatch only event APIs in the given application domains. *
Optional
availableAdditionally match any shared event APIs in any application domain. *
Optional
brokerMatch only event APIs with the given broker type. *
Optional
customReturns the entities that match the custom attribute filter.
To filter by custom attribute name and value, use the format: customAttributes=<custom-attribute-name>==<custom-attribute-value>
.
To filter by custom attribute name, use the format: customAttributes=<custom-attribute-name>
.
The filter supports the AND
operator for multiple custom attribute definitions (not multiple values for a given definition). Use ;
(semicolon
) to separate multiple queries with AND
operation.
Note: the filter supports custom attribute values containing only the characters [a-zA-Z0-9_\-\. ]
. *
Optional
eventMatch only event APIs in the given event API version ids. *
Optional
ids?: string[]Match only event APIs with the given IDs separated by commas. *
Optional
name?: stringName of the event API to match on. *
Optional
pageThe page number to get. *
Optional
pageThe number of event APIs to get per page. *
Optional
shared?: booleanMatch only with shared or unshared event APIs. *
Optional
sort?: stringSort based on the provided parameters.
The value can be either a standalone field name (?sort=<field>
) or a field and direction, delimited by a colon (?sort=<field>:<asc|desc>
). If the direction is not specified, the default is ascending. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an Event API
Use this API to update an event API. You only need to specify the fields that need to be updated.
Token Permissions: [ event_api:update:*
]
EventApiResponse The updated event API.
ApiError
Static
updateUpdate an Event API by Event API Version ID
Use this API to update an event API version by event API version ID.You only need to specify the fields that need to be updated.
Token Permissions: [ event_api:update:*
]
EventApiVersionResponse The updated event API version.
ApiError
The event API version. *
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to update an event API version. You only need to specify the fields that need to be updated.
EventApiVersionResponse The updated event API version.
ApiError
The ID of the parent event API. *
The ID of the event API version to update. *
The event API version. *
Optional
xOptional context id the request is running. *
Static
updateUpdate the State of an Event API Version by Event API Version ID
Use this API to update the state of an event API version. You only need to specify the state ID field with the desired state ID.
Token Permissions: [ event_api:update_state:*
]
StateChangeRequestResponse The updated state of the event API version.
ApiError
The Event API version. *
The ID of the event API version. *
Optional
xOptional context id the request is running. *
Static
updateUpdate the State of an Event API Version
*Deprecation Date: 2022-11-01
Removal Date: 2023-12-01
Reason: Replaced by another endpoint.
*Use this API to update the state of an event API version. You only need to specify the state ID field with the desired state ID.
VersionedObjectStateChangeRequest The updated state of the event API version.
ApiError
The ID of the parent event API. *
The ID of the event API version to update. *
The event API version. *
Optional
xOptional context id the request is running. *
Create an Event API Use this API to create an event API.
Token Permissions: [
event_api:create:*
]Returns
EventApiResponse Created an event API. The newly saved event API is returned in the response body.
Throws
ApiError