---
canonical_url: "https://docs.composio.dev/toolkits/dev_cycle"
markdown_url: "https://docs.composio.dev/toolkits/dev_cycle.md"
product: "platform"
version: null
last_updated: null
---

# DevCycle

DevCycle is a feature management platform for creating, targeting, releasing, and monitoring feature flags across applications.

- **Category:** developer tools
- **Auth:** S2S_OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `DEV_CYCLE`
- **Version:** 00000000_00

## Tools

### Create Variable

**Slug:** `DEV_CYCLE_CREATE_VARIABLE`

Create a typed variable in a DevCycle project, optionally associating it with a feature.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Unique variable key within the project. |
| `name` | string | No | Human-readable variable name. |
| `tags` | array | No | Tags used to organize the variable. |
| `project` | string | Yes | Project key or stable project ID. |
| `feature_id` | string | No | Stable ID of the feature this variable belongs to. |
| `description` | string | No | Purpose and intended use of the variable. |
| `variable_type` | string ("String" | "Boolean" | "Number" | "JSON") | Yes | Type of values held by the variable. |
| `validation_schema` | object | No | Official DevCycle validation schema for variable values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Variable

**Slug:** `DEV_CYCLE_DELETE_VARIABLE`

Permanently delete exactly one DevCycle variable, selected by key or stable ID, from the specified project. This operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project` | string | Yes | Project key or stable project ID containing the variable. |
| `variable` | string | Yes | Key or stable ID of the single variable to permanently delete. This operation cannot be undone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Audiences

**Slug:** `DEV_CYCLE_LIST_AUDIENCES`

List and search project audiences, optionally including whether each audience is used.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Search audiences by provider-supported fields (at least 3 characters). |
| `project` | string | Yes | Project key or stable project ID. |
| `sort_by` | string ("createdAt" | "updatedAt" | "name" | "key" | "propertyKey") | No | Audience field used for sorting. |
| `per_page` | integer | No | Maximum audiences to return in this page (1-1000). |
| `created_by` | string | No | Filter by creator user ID. |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `include_usage` | boolean | No | Include whether each audience is currently used by a feature. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Environments

**Slug:** `DEV_CYCLE_LIST_ENVIRONMENTS`

List environments in a DevCycle project without exposing SDK key values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Search environments by provider-supported fields (minimum 3 characters). |
| `project` | string | Yes | Project key or stable project ID. |
| `sort_by` | string ("createdAt" | "updatedAt" | "name" | "key" | "propertyKey") | No | Environment field used for sorting. |
| `per_page` | integer | No | Maximum environments to return in this page (1-1000). |
| `created_by` | string | No | Filter by creator user ID. |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Feature Configurations

**Slug:** `DEV_CYCLE_LIST_FEATURE_CONFIGURATIONS`

Inspect a feature's targeting configurations across all environments or one selected environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feature` | string | Yes | Feature key or stable feature ID. |
| `project` | string | Yes | Project key or stable project ID. |
| `environment` | string | No | Environment key or stable ID; omit to return configurations for all environments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Features

**Slug:** `DEV_CYCLE_LIST_FEATURES`

List and filter current Feature v2 resources in a DevCycle project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keys` | array | No | Return only features with these keys. |
| `search` | string | No | Search features by provider-supported fields (at least 3 characters). |
| `status` | string ("active" | "complete" | "archived") | No | Filter by feature lifecycle status. |
| `project` | string | Yes | Project key or stable project ID. |
| `sort_by` | string ("createdAt" | "updatedAt" | "name" | "key" | "propertyKey") | No | Feature field used for sorting. |
| `per_page` | integer | No | Maximum features to return in this page (1-1000). |
| `staleness` | string ("all" | "unused" | "released" | "unmodified" | "notStale") | No | Filter by DevCycle staleness classification. |
| `created_by` | string | No | Filter by creator user ID. |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `feature_type` | string ("release" | "experiment" | "permission" | "ops") | No | Filter by feature type. |
| `custom_status_ids` | array | No | Filter by custom status IDs. |
| `include_latest_update` | boolean | No | Include the latest audit update for each feature. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `DEV_CYCLE_LIST_PROJECTS`

List DevCycle projects visible to the connected Management service account, with filtering and controlled pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Search projects by provider-supported project fields. |
| `sort_by` | string ("createdAt" | "updatedAt" | "name" | "key" | "propertyKey") | No | Project field used for sorting. |
| `per_page` | integer | No | Maximum projects to return in this page (1-1000). |
| `created_by` | string | No | Filter by the ID of the user that created the project. |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Variables

**Slug:** `DEV_CYCLE_LIST_VARIABLES`

List and filter variables in a DevCycle project, including variables associated with a feature.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Search variables by provider-supported fields (minimum 3 characters). |
| `status` | string ("active" | "archived") | No | Filter by variable lifecycle status. |
| `feature` | string | No | Filter by feature key or stable feature ID. |
| `project` | string | Yes | Project key or stable project ID. |
| `sort_by` | string ("createdAt" | "updatedAt" | "name" | "key" | "propertyKey") | No | Variable field used for sorting. |
| `per_page` | integer | No | Maximum variables to return in this page (1-1000). |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `variable_type` | string ("String" | "Boolean" | "Number" | "JSON") | No | Filter by variable value type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Variable

**Slug:** `DEV_CYCLE_UPDATE_VARIABLE`

Update one or more editable properties of an existing DevCycle variable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New human-readable variable name. |
| `tags` | array | No | Replacement organization tags. |
| `new_key` | string | No | New unique variable key; the variable path selector remains unchanged for this request. |
| `project` | string | Yes | Project key or stable project ID. |
| `variable` | string | Yes | Variable key or stable variable ID. |
| `persistent` | boolean | No | Whether the variable is intended to be long-lived within a feature. |
| `description` | string | No | New variable description. |
| `variable_type` | string ("String" | "Boolean" | "Number" | "JSON") | No | New variable value type. |
| `validation_schema` | object | No | New official DevCycle validation schema object. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |