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