V1/dynamic_behavior_set
Was this helpful?
Was this helpful?
Delete a dynamic behavior set.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
on the authenticated user.
DynamicBehaviorInstruction:DeleteDynamicBehaviorInstruction
on the dynamic behavior set to delete.
The ID of the dynamic behavior set to delete.
^[a-f0-9]{24}$
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
No content
Get the versions of a dynamic behavior set.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
for the authenticated user.
DynamicBehaviorInstruction:GetDynamicBehaviorInstruction
for the dynamic behavior set to retrieve.
The ID of the dynamic behavior set.
^[a-f0-9]{24}$
The versions of the dynamic behavior set to retrieve. One can specify an exact version to retrieve, which is either the version number or latest
, which retrieves the latest version. Alternatively, one can specify a range of inclusive lower and upper bound for the version number separated by -
, and every version within the range would be retrieved.
1
The maximum number of dynamic behavior set versions to return.
10
The continuation token from the previous request used to retrieve the next page of dynamic behavior set versions.
0
The fields to sort the versions by. Supported fields are version
. Specify a +
before the field name to indicate ascending sorting and -
for descending sorting. Multiple fields can be specified to break ties.
[]
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
Search for dynamic behavior sets that match the given filters and contain the given query in its name and the triggers of its latest version. Only the top 50 results will be returned. The results will be sorted by the relevance of the search query.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
for the authenticated user.
This endpoint may be impacted by the following permissions:
Only dynamic behavior sets that the authenticated user has DynamicBehaviorInstruction:GetDynamicBehaviorInstruction
permission for will be retrieved.
The query to search for. Any sets containing the terms in its name and the triggers of its latest version would be returned.
Whether the dynamic behavior set is active.
The IDs of the services that the dynamic behavior set is applied to.
The creators of the dynamic behavior sets. Each value must be of the format org_id,user_id
.
The tags of the dynamic behavior sets. Must be specified using the syntax key:value
, which means to match all sets with the given key
and value
pair among its tags. If value
is *
, it means the value
does not matter. If value
is empty, it matches against when the value is None
.
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
Retrieve dynamic behavior sets that match the given filters.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
for the authenticated user.
This endpoint may be impacted by the following permissions:
Only dynamic behavior sets that the authenticated user has DynamicBehaviorInstruction:GetDynamicBehaviorInstruction
permission for will be retrieved.
The ID of the dynamic behavior set to retrieve.
The maximum number of dynamic behavior sets to return.
50
The continuation token from the previous request used to retrieve the next page of dynamic behavior sets.
0
Whether the dynamic behavior set is active.
The IDs of the services that the dynamic behavior set is applied to.
[]
The creators of the dynamic behavior sets. Each value must be of the format org_id,user_id
.
[]
The tags of the dynamic behavior sets. Must be specified using the syntax key:value
, which means to match all sets with the given key
and value
pair among its tags. If value
is *
, it means the value
does not matter. If value
is empty, it matches against when the value is None
.
[]
The fields to sort the sets by. Supported fields are updated_at
. Specify a +
before the field name to indicate ascending sorting and -
for descending sorting. Multiple fields can be specified to break ties.
[]
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
Create a new dynamic behavior set as well as its initial version.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
on the authenticated user.
DynamicBehaviorInstruction:CreateDynamicBehaviorInstruction
on the set to create.
DynamicBehaviorInstruction:UpdateDynamicBehaviorInstruction
on the set to create.
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
The name of the dynamic behavior set.
The services that the dynamic behavior set should be applied to.
Update a dynamic behavior set.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
on the authenticated user.
DynamicBehaviorInstruction:UpdateDynamicBehaviorInstruction
on the dynamic behavior set to update.
The ID of the dynamic behavior set to delete.
^[a-f0-9]{24}$
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
The tags of the dynamic behavior set. Both the key and the value can only contain alphanumeric characters, underscores, or spaces.
The services that the dynamic behavior set should be applied to.
Whether the dynamic behavior set is active.
No content
Create a new version of the given dynamic behavior set.
Permissions
This endpoint requires the following permissions:
User:GetUserInfo
on the authenticated user.
DynamicBehaviorInstruction:UpdateDynamicBehaviorInstruction
on the dynamic behavior set to create a new version for.
The ID of the dynamic behavior set to delete.
^[a-f0-9]{24}$
The version number of the new version. If specified, this endpoint throws an error if the next version in the database doesn't equal to the value of this parameter.
The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.
The conversation triggers for the dynamic behavior set version.