# Split

Split feature flags: splits, environments, segments, change requests. Exposes **27 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `split_workspaces_list` | List workspaces - GET /workspaces. |
| `split_workspace_get` | Get one workspace by ID - GET /workspaces/{workspace_id}. |
| `split_environments_list` | List environments in a workspace - GET /workspaces/{workspace_id}/environments. |
| `split_environment_get` | Get one environment - GET /workspaces/{workspace_id}/environments/{environment_id}. |
| `split_environment_create` | Create an environment - POST /workspaces/{workspace_id}/environments. |
| `split_splits_list` | List feature flags (splits) in an environment - GET /workspaces/{workspace_id}/environments/{environment_id}/splits. |
| `split_split_get` | Get one feature flag definition - GET /workspaces/{workspace_id}/environments/{environment_id}/splits/{split_name}. |
| `split_split_create` | Create a new feature flag - POST /workspaces/{workspace_id}/environments/{environment_id}/splits. |
| `split_split_update_definition` | Update feature flag definition - PUT /workspaces/{workspace_id}/environments/{environment_id}/splits/{split_name}. |
| `split_split_kill` | Kill a feature flag - POST /workspaces/{workspace_id}/environments/{environment_id}/splits/{split_name}/kill. |
| `split_split_restore` | Restore a killed feature flag - POST /workspaces/{workspace_id}/environments/{environment_id}/splits/{split_name}/restore. |
| `split_segments_list` | List segments (audience groups) - GET /workspaces/{workspace_id}/environments/{environment_id}/segments. |
| `split_segment_get` | Get one segment - GET /workspaces/{workspace_id}/environments/{environment_id}/segments/{segment_name}. |
| `split_segment_create` | Create a segment - POST /workspaces/{workspace_id}/environments/{environment_id}/segments. |
| `split_segment_update_keys` | Add or remove keys from a segment - PATCH /workspaces/{workspace_id}/environments/{environment_id}/segments/{segment_name}. |
| `split_traffic_types_list` | List traffic types (dimensions for feature flag targeting) - GET /workspaces/{workspace_id}/traffic-types. |
| `split_traffic_type_get` | Get one traffic type - GET /workspaces/{workspace_id}/traffic-types/{traffic_type_name}. |
| `split_tags_list` | List tags in a workspace - GET /workspaces/{workspace_id}/tags. |
| `split_tag_get` | Get one tag - GET /workspaces/{workspace_id}/tags/{tag_name}. |
| `split_change_requests_list` | List change requests (pending/approved modifications) - GET /workspaces/{workspace_id}/environments/{environment_id}/change-requests. |
| `split_change_request_get` | Get one change request - GET /workspaces/{workspace_id}/environments/{environment_id}/change-requests/{change_request_id}. |
| `split_change_request_approve` | Approve a change request - POST /workspaces/{workspace_id}/environments/{environment_id}/change-requests/{change_request_id}/approve. |
| `split_change_request_reject` | Reject a change request - POST /workspaces/{workspace_id}/environments/{environment_id}/change-requests/{change_request_id}/reject. |
| `split_users_list` | List users in workspace - GET /workspaces/{workspace_id}/users. |
| `split_user_get` | Get one user - GET /workspaces/{workspace_id}/users/{user_id}. |
| `split_groups_list` | List groups (team groups/roles) in workspace - GET /workspaces/{workspace_id}/groups. |
| `split_group_get` | Get one group - GET /workspaces/{workspace_id}/groups/{group_id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`SPLIT_ADMIN_API_KEY`** - Split - Admin settings - API keys - Admin (read-write). (https://app.split.io/)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `SPLIT_ADMIN_API_KEY` | Split - Admin settings - API keys - Admin (read-write). |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Split API documentation](https://docs.split.io/reference)