Static
createEnumeration description. *
Optional
xOptional context id the request is running. *
Static
createCreate an enumeration version
Create an enumeration version.
Token Permissions: [ ep_enum:update:*
]
TopicAddressEnumVersionResponse Created an enumeration version and its values. The newly saved enumeration version is returned in the response body.
ApiError
Enumeration version description with its values. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an enumeration
Use this API to delete an enumeration. The enumeration must not have any versions or else it cannot be deleted.
Token Permissions: [ ep_enum:delete:*
]
void
ApiError
The ID of the enumeration. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an enumeration version
Use this API to delete an enumeration version. The version must not be in use by any events else it cannot be deleted. This also deletes the version's values.
Token Permissions: [ ep_enum:update:*
]
void
ApiError
The ID of the enumeration version. *
Optional
xOptional context id the request is running. *
Static
getGet an enumeration
Use this API to get a single enumeration by its ID.
Token Permissions: [ ep_enum:get:*
]
TopicAddressEnumResponse The enumeration.
ApiError
The ID of the enumeration. *
Optional
xOptional context id the request is running. *
Static
getGet an enumeration version
Use this API to get a single enumeration version by its ID.
Token Permissions: [ ep_enum:get:*
]
TopicAddressEnumVersionResponse The enumeration version.
ApiError
The ID of the enumeration version. *
Optional
xOptional context id the request is running. *
Static
getGet a list of enumeration versions
Use this API to get a list of enumeration versions that match the given parameters.
Token Permissions: [ event_designer:access
]
TopicAddressEnumVersionsResponse Get a list of enumeration versions and the accompanying metadata.
ApiError
Optional
enumMatch only enumeration versions of these enumeration IDs, separated by commas. *
Optional
ids?: string[]Match only enumeration versions with the given IDs, separated by commas. *
Optional
pageThe page number to get. *
Optional
pageThe number of enumeration versions to get per page. *
Optional
xOptional context id the request is running. *
Static
getGet a list of enumerations
Use this API to get a list of enumerations based on certain criteria.
Token Permissions: [ event_designer:access
]
TopicAddressEnumsResponse Get a list of enumerations and the accompanying metadata.
ApiError
Optional
applicationThe application domain ID of the enumerations. *
Optional
applicationMatch only enumerations in the given application domain ids. *
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
ids?: string[]The IDs of the enumerations. *
Optional
names?: string[]The names of the enumerations. *
Optional
pageThe page number to get. *
Optional
pageThe number of enumerations to get per page. *
Optional
shared?: booleanMatch only with shared or unshared enumerations. *
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 enumeration
Use this API to update an enumeration object. You only need to specify the fields that need to be updated.
Token Permissions: [ ep_enum:update:*
]
TopicAddressEnumResponse Updated an enumeration. The newly saved enumeration is returned in the response body.
ApiError
The ID of the enumeration. *
Enumeration updates. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an enumeration version
Use this API to update an enumeration version. You only need to specify the fields that need to be updated.
Token Permissions: [ ep_enum:update:*
]
TopicAddressEnumVersionResponse The updated enumeration version.
ApiError
The ID of the enumeration version to update. *
The enumeration version. *
Optional
xOptional context id the request is running. *
Static
updateUpdate the state of an enumeration version
Use this API to update the state of an enumeration version. You only need to specify the target stateId field.
Token Permissions: [ ep_enum:update_state:*
]
StateChangeRequestResponse The updated state of the enumeration version.
ApiError
The ID of the enumeration version to update. *
The state object. *
Optional
xOptional context id the request is running. *
Create an enumeration An enumeration is a bounded variable with a limited set of literal values. Use this API to create an enumeration to define acceptable values for a level in a topic address or topic domain.
Token Permissions: [
ep_enum:create:*
]Returns
TopicAddressEnumResponse Created an enumeration. The newly saved enumeration is returned in the response body.
Throws
ApiError