---
title: "Search dynamic behavior sets"
method: GET
path: "/v1/{organization}/dynamic_behavior_set/search"
tags: ["Dynamic Behavior Set"]
---

# Search dynamic behavior sets

`GET /v1/{organization}/dynamic_behavior_set/search`

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 may be impacted by the following permissions:
* Only dynamic behavior sets that the authenticated user has `DynamicBehaviorInstruction:GetDynamicBehaviorInstruction` permission for will be retrieved.

## Path parameters

- `organization` string, required

## Query parameters

- `query` string, required
- `is_active` boolean, nullable — Whether the dynamic behavior set is active.
- `applied_to_service` string[] — The IDs of the services that the dynamic behavior set is applied to.
- `creator` string[] — The creators of the dynamic behavior sets. Each value must be of the format `org_id,user_id`.
- `tag` string[] — 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`.

## Headers

- `x-mongo-cluster-name` string, nullable — 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.
- `Sec-WebSocket-Protocol` string[]

## Response `200`

Succeeded.

- SrcAppEndpointsDynamicBehaviorSetSearchDynamicBehaviorSetsResponse
  - `dynamic_behavior_sets` DynamicBehaviorSetInstance[], required — The retrieved dynamic behavior sets.
    - `id` string, required
    - `name` string, required
    - `is_active` boolean, required
    - `applied_to_services` string[], required
    - `tags` object, required
    - `created_at` string, date-time, required
    - `creator` AmigoLibMongoCollectionsDynamicBehaviorSetDynamicBehaviorSetUserInfo, required
      - `org_id` string, required
      - `user_id` string, required
    - `updated_at` string, date-time, required
    - `updated_by` AmigoLibMongoCollectionsDynamicBehaviorSetDynamicBehaviorSetUserInfo, required
      - `org_id` string, required
      - `user_id` string, required

## Other responses

- `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.

---

[API](https://skmtc.net/amigo/apis/amigo-api.md) · [All operations](https://skmtc.net/amigo/apis/amigo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amigo/amigo-api/revisions/f0f28319e448/schema)