> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/feature-management-experimentation/split-api-reference/identities.md).

# Identities

## Save Identities

> Create or overwrite identities for a given traffic type and environment. The attribute ID must start with a letter followed by a combination of dashes (-), underscores (\_), letters (a-z A-Z), or numbers (0-9). Include the list of identities and their attributes to create or overwrite in the JSON body.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Identities"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/trafficTypes/{traffic-type-id}/environments/{environment-id}/identities":{"post":{"summary":"Save Identities","description":"Create or overwrite identities for a given traffic type and environment. The attribute ID must start with a letter followed by a combination of dashes (-), underscores (_), letters (a-z A-Z), or numbers (0-9). Include the list of identities and their attributes to create or overwrite in the JSON body.","operationId":"save-identities","parameters":[{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The ID of the traffic type of the identities"},{"in":"path","name":"environment-id","schema":{"type":"string"},"required":true,"description":"The ID of the FME environment where you want to save the identities"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"404":{"description":"404","content":{"application/json":{}}}},"deprecated":false,"tags":["Identities"]}}}}
```

## Save Identity

> Create or overwrite a single key for a given traffic type and environment. The attribute ID must start with a letter followed by a combination of dashes (-), underscores (\_), letters (a-z A-Z), or numbers (0-9). Include the identity attributes to create or overwrite in the JSON body.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Identities"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/trafficTypes/{traffic-type-id}/environments/{environment-id}/identities/{key}":{"put":{"summary":"Save Identity","description":"Create or overwrite a single key for a given traffic type and environment. The attribute ID must start with a letter followed by a combination of dashes (-), underscores (_), letters (a-z A-Z), or numbers (0-9). Include the identity attributes to create or overwrite in the JSON body.","operationId":"save-identity","parameters":[{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The ID of the traffic type of the identity"},{"in":"path","name":"environment-id","schema":{"type":"string"},"required":true,"description":"The ID of the FME environment where you want to save the identity"},{"in":"path","name":"key","schema":{"type":"string"},"required":true,"description":"The key used for getTreatment calls for the object this identity represents"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"404":{"description":"404","content":{"application/json":{}}}},"deprecated":false,"tags":["Identities"]}}}}
```

## Delete Identity

> Delete a key from a given traffic type and environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Identities"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/trafficTypes/{traffic-type-id}/environments/{environment-id}/identities/{key}":{"delete":{"summary":"Delete Identity","description":"Delete a key from a given traffic type and environment.","operationId":"delete-identitiy","parameters":[{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The ID of the traffic type of the identity"},{"in":"path","name":"environment-id","schema":{"type":"string"},"required":true,"description":"The ID of the FME environment where you want to delete the identity"},{"in":"path","name":"key","schema":{"type":"string"},"required":true,"description":"The key used for getTreatment calls for the object this identity represents"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"boolean","default":true}}}},"404":{"description":"404","content":{"application/json":{}}}},"deprecated":false,"tags":["Identities"]}}}}
```

## Update Identity

> Update a single key for a given traffic type and environment. Any provided attribute values are overwritten, but existing values otherwise remain. The attribute ID must start with a letter followed by a combination of dashes(-), underscores(\_), letters(a-z A-Z), or numbers(0-9).

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Identities"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/trafficTypes/{traffic-type-id}/environments/{environment-id}/identities/{key}":{"patch":{"summary":"Update Identity","description":"Update a single key for a given traffic type and environment. Any provided attribute values are overwritten, but existing values otherwise remain. The attribute ID must start with a letter followed by a combination of dashes(-), underscores(_), letters(a-z A-Z), or numbers(0-9).","operationId":"update-identity","parameters":[{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The ID of the traffic type of the identity"},{"in":"path","name":"environment-id","schema":{"type":"string"},"required":true,"description":"The ID of the FME environment where you want to update the identity"},{"in":"path","name":"key","schema":{"type":"string"},"required":true,"description":"The key used for getTreatment calls for the object this identity represents"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"404":{"description":"404","content":{"application/json":{}}}},"deprecated":false,"tags":["Identities"]}}}}
```
