LogoLogo
Go to website
  • Welcome
  • Getting Started
    • Amigo Overview
      • System Components
      • Overcoming LLM Limitations
      • [Advanced] Future-Ready Architecture
      • [Advanced] The Accelerating AI Landscape
    • The Journey with Amigo
      • Partnership Model
  • Concepts
    • Agent Core
      • Core Persona
      • Global Directives
    • Context Graphs
      • State-Based Architecture
      • [Advanced] Field Implementation Guidance
    • Functional Memory
      • Layered Architecture
      • User Model
      • [Advanced] Recall Mechanisms
      • [Advanced] Analytical Capabilities
    • Dynamic Behaviors
      • Side-Effect Architecture
      • Knowledge
      • [Advanced] Behavior Chaining
    • Evaluations
      • Testing Framework Examples
    • [Advanced] Reinforcement Learning
    • Safety
  • Glossary
  • Advanced Topics
    • Transition to Neuralese Systems
    • Agent V2 Architecture
  • Agent Building Best Practices
    • Dynamic Behaviors Guide
  • Developer Guide
    • Enterprise Integration Guide
      • Authentication
      • User Creation + Management
      • Service Discovery + Management
      • Conversation Creation + Management
      • Data Retrieval + User Model Management
      • Webhook Management
    • API Reference
      • V1/organization
      • V1/service
      • V1/conversation
      • V1/user
      • V1/role
      • V1/admin
      • V1/webhook_destination
      • V1/metric
      • V1/dynamic_behavior_set
      • V1/simulation
      • Models
Powered by GitBook
LogoLogo

Resources

  • Pricing
  • About Us

Company

  • Careers

Policies

  • Terms of Service

Amigo Inc. ©2025 All Rights Reserved.


On this page

Was this helpful?

Export as PDF
  1. Developer Guide
  2. API Reference

V1/dynamic_behavior_set

PreviousV1/metricNextV1/simulation

Was this helpful?

Delete a dynamic behavior instruction

delete

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.

Authorizations
Path parameters
organizationstringRequired
dynamic_behavior_set_idstringRequired

The ID of the dynamic behavior set to delete.

Pattern: ^[a-f0-9]{24}$
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Responses
200
Succeeded.
application/json
Responseany
401
Invalid authorization credentials.
403
Missing required permissions.
404
The specified organization or dynamic behavior set does not exist.
422
Invalid request path parameter failed validation.
429
The user has exceeded the rate limit of 500 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
delete
DELETE /v1/{organization}/dynamic_behavior_set/{dynamic_behavior_set_id}/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Accept: */*

No content

Get dynamic behavior set versions

get

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.

Authorizations
Path parameters
organizationstringRequired
dynamic_behavior_set_idstringRequired

The ID of the dynamic behavior set.

Pattern: ^[a-f0-9]{24}$
Query parameters
versionany ofOptional

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.

Example: 1
stringOptional
or
nullOptional
limitinteger · min: 1 · max: 10Optional

The maximum number of dynamic behavior set versions to return.

Default: 10
continuation_tokenintegerOptional

The continuation token from the previous request used to retrieve the next page of dynamic behavior set versions.

Default: 0
sort_bystring[]Optional

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.

Default: []
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Responses
200
Succeeded.
application/json
401
Invalid authorization credentials.
403
Missing required permissions.
404
Specified organization or dynamic behavior set is not found.
422
Invalid request path parameter or request query parameter failed validation.
429
The user has exceeded the rate limit of 500 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
get
GET /v1/{organization}/dynamic_behavior_set/{dynamic_behavior_set_id}/version/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Accept: */*
{
  "dynamic_behavior_set_versions": [
    {
      "_id": "text",
      "org_id": "text",
      "dynamic_behavior_set_id": "text",
      "version": 1,
      "conversation_triggers": [
        "text"
      ],
      "action": {
        "type": "text",
        "instruction": "text",
        "overrides_instructions": true
      }
    }
  ],
  "has_more": true,
  "continuation_token": 1
}

Search dynamic behavior sets

get

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.

Authorizations
Path parameters
organizationstringRequired
Query parameters
querystring · min: 1Required

The query to search for. Any sets containing the terms in its name and the triggers of its latest version would be returned.

is_activeany ofOptional

Whether the dynamic behavior set is active.

booleanOptional
or
nullOptional
applied_to_serviceany ofOptional

The IDs of the services that the dynamic behavior set is applied to.

string[]Optional
or
nullOptional
creatorany ofOptional

The creators of the dynamic behavior sets. Each value must be of the format org_id,user_id.

string[]Optional
or
nullOptional
tagany ofOptional

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.

string[]Optional
or
nullOptional
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Responses
200
Succeeded.
application/json
401
Invalid authorization credentials.
403
Missing required permissions.
404
Specified organization is not found.
422
Invalid request path parameter or request query parameter failed validation.
429
The user has exceeded the rate limit of 50 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
get
GET /v1/{organization}/dynamic_behavior_set/search HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Accept: */*
{
  "dynamic_behavior_sets": [
    {
      "id": "text",
      "name": "text",
      "is_active": true,
      "applied_to_services": [
        "text"
      ],
      "tags": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "created_at": "2025-05-10T05:49:46.900Z",
      "creator": {
        "org_id": "text",
        "user_id": "text"
      },
      "updated_at": "2025-05-10T05:49:46.900Z",
      "updated_by": {
        "org_id": "text",
        "user_id": "text"
      }
    }
  ]
}
  • GETGet dynamic behavior sets
  • POSTCreate a dynamic behavior set
  • POSTUpdate a dynamic behavior set
  • DELETEDelete a dynamic behavior instruction
  • GETGet dynamic behavior set versions
  • POSTCreate a new version of a dynamic behavior set.
  • GETSearch dynamic behavior sets

Get dynamic behavior sets

get

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.

Authorizations
Path parameters
organizationstringRequired
Query parameters
idany ofOptional

The ID of the dynamic behavior set to retrieve.

string[]Optional
or
nullOptional
limitinteger · max: 50Optional

The maximum number of dynamic behavior sets to return.

Default: 50
continuation_tokenintegerOptional

The continuation token from the previous request used to retrieve the next page of dynamic behavior sets.

Default: 0
is_activeany ofOptional

Whether the dynamic behavior set is active.

booleanOptional
or
nullOptional
applied_to_servicestring[]Optional

The IDs of the services that the dynamic behavior set is applied to.

Default: []
creatorstring[]Optional

The creators of the dynamic behavior sets. Each value must be of the format org_id,user_id.

Default: []
tagstring[]Optional

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.

Default: []
sort_bystring[]Optional

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.

Default: []
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Responses
200
Succeeded.
application/json
401
Invalid authorization credentials.
403
Missing required permissions.
404
Specified organization is not found.
422
Invalid request path parameter or request query parameter failed validation.
429
The user has exceeded the rate limit of 50 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
get
GET /v1/{organization}/dynamic_behavior_set/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Accept: */*
{
  "dynamic_behavior_sets": [
    {
      "id": "text",
      "name": "text",
      "is_active": true,
      "applied_to_services": [
        "text"
      ],
      "tags": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "created_at": "2025-05-10T05:49:46.900Z",
      "creator": {
        "org_id": "text",
        "user_id": "text"
      },
      "updated_at": "2025-05-10T05:49:46.900Z",
      "updated_by": {
        "org_id": "text",
        "user_id": "text"
      }
    }
  ],
  "has_more": true,
  "continuation_token": 1,
  "filter_values": {
    "applied_to_services_ids": [
      "text"
    ],
    "creators": [
      {
        "org_id": "text",
        "user_id": "text"
      }
    ],
    "tags": [
      "text"
    ]
  }
}

Create a dynamic behavior set

post

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.

Authorizations
Path parameters
organizationstringRequired
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Body
namestring · min: 1Required

The name of the dynamic behavior set.

applied_to_servicesstring[]Required

The services that the dynamic behavior set should be applied to.

Responses
201
Succeeded.
application/json
401
Invalid authorization credentials.
403
Missing required permissions.
404
The specified organization or service does not exist.
409
If the initial version is defined and `is_active` is set to `True`, an active dynamic behavior set with the same name already exists.
422
Invalid request path parameter or request body failed validation.
429
The user has exceeded the rate limit of 500 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
post
POST /v1/{organization}/dynamic_behavior_set/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 234

{
  "name": "text",
  "tags": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "applied_to_services": [
    "text"
  ],
  "initial_version": {
    "is_active": true,
    "conversation_triggers": [
      "text"
    ],
    "action": {
      "type": "text",
      "instruction": "text",
      "overrides_instructions": true
    }
  }
}
{
  "dynamic_behavior_set_id": "text"
}

Update a dynamic behavior set

post

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.

Authorizations
Path parameters
organizationstringRequired
dynamic_behavior_set_idstringRequired

The ID of the dynamic behavior set to delete.

Pattern: ^[a-f0-9]{24}$
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Body
tagsany ofOptional

The tags of the dynamic behavior set. Both the key and the value can only contain alphanumeric characters, underscores, or spaces.

or
nullOptional
applied_to_servicesany ofOptional

The services that the dynamic behavior set should be applied to.

string[]Optional
or
nullOptional
is_activeany ofOptional

Whether the dynamic behavior set is active.

booleanOptional
or
nullOptional
Responses
204
Succeeded.
401
Invalid authorization credentials.
403
Missing required permissions.
404
The specified organization, dynamic behavior set, or service does not exist.
409
Another active set with the same name already exists.
422
Invalid request path parameter or request body failed validation.
429
The user has exceeded the rate limit of 500 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
post
POST /v1/{organization}/dynamic_behavior_set/{dynamic_behavior_set_id}/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "tags": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "applied_to_services": [
    "text"
  ],
  "is_active": true
}

No content

Create a new version of a dynamic behavior set.

post

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.

Authorizations
Path parameters
organizationstringRequired
dynamic_behavior_set_idstringRequired

The ID of the dynamic behavior set to delete.

Pattern: ^[a-f0-9]{24}$
Query parameters
versionany ofOptional

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.

integerOptional
or
nullOptional
Header parameters
x-mongo-cluster-nameany ofOptional

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.

stringOptional
or
nullOptional
Body
conversation_triggersstring[] · min: 1 · max: 50Required

The conversation triggers for the dynamic behavior set version.

Responses
201
Succeeded.
application/json
400
The specified version number is not the expected next version to be created.
401
Invalid authorization credentials.
403
Missing required permissions.
404
The specified organization or dynamic behavior set does not exist.
422
Invalid request path parameter, request query parameter, or request body failed validation.
429
The user has exceeded the rate limit of 500 requests per minute for this endpoint.
503
The service is going through temporary maintenance.
post
POST /v1/{organization}/dynamic_behavior_set/{dynamic_behavior_set_id}/version/ HTTP/1.1
Host: api.amigo.ai
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "conversation_triggers": [
    "text"
  ],
  "action": {
    "type": "text",
    "instruction": "text",
    "overrides_instructions": true
  }
}
{
  "new_version_number": 1
}