> 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/attributes.md).

# Attributes

## Get Attributes

> Get all attributes for a trafficType. Non-paginated operation is deprecated, prefer setting the paginate flag to true. When using pagination, the default markerLimit is 50, maximum markerLimit is 200.  \
> \
> Pagination examples:\
> &#x20; \- Page Forward: Send Next Marker into After Marker parameter\
> &#x20; \- Reload Page (when paging forward): Send Previous Marker into After Marker parameter\
> &#x20; \- Page Backwards: Send Previous Marker into Before Marker parameter\
> &#x20; \- Reload Page (when paging backwards): Send Next Marker into Before Marker parameter

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Attributes"}],"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":{"/schema/ws/{workspace-id}/trafficTypes/{traffic-type-id}":{"get":{"summary":"Get Attributes","description":"Get all attributes for a trafficType. Non-paginated operation is deprecated, prefer setting the paginate flag to true. When using pagination, the default markerLimit is 50, maximum markerLimit is 200.  \n\nPagination examples:\n  - Page Forward: Send Next Marker into After Marker parameter\n  - Reload Page (when paging forward): Send Previous Marker into After Marker parameter\n  - Page Backwards: Send Previous Marker into Before Marker parameter\n  - Reload Page (when paging backwards): Send Next Marker into Before Marker parameter","operationId":"get-attributes","parameters":[{"name":"Paginate","in":"query","description":"Whether to paginate the response.","schema":{"type":"boolean","default":false}},{"name":"searchPrefix","in":"query","description":"Search prefix under which to look for attributes (ex. `att` returns `attribute1`, but not `myAttribute`).  Search is case insensitive, and only available with pagination.","schema":{"type":"string"}},{"name":"afterMarker","in":"query","description":"Get results 'After' the marker passed into this parameter. Only available with pagination. Markers are obfuscated strings by design.","schema":{"type":"string"}},{"name":"beforeMarker","in":"query","description":"Get results 'Before' the marker passed into this parameter. Only available with pagination. Markers are obfuscated strings by design.","schema":{"type":"string"}},{"name":"markerLimit","in":"query","description":"Limit the number of return objects. If nothing or something invalid is given, then this will be the default markerLimit for the query. If something greater than the maximum limit is passed in, this will be the maximum allowed markerLimit for this query.","schema":{"type":"integer","format":"int32","default":50}},{"name":"Authorization","in":"header","schema":{"type":"string","default":"Bearer ADMIN_API_KEY"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) you want attributes from. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The ID of the traffic type to fetch attributes from"}],"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Attributes"]}}}}
```

## Save Attribute

> Save an attribute for a traffic type ID. The attribute is created if it does not exist, and is overwritten completely with the provided attribute object if it does. This endpoint also accepts a PUT that behaves identically to the POST, but the POST is preferred. Use the PATCH endpoint for partial updates. 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":"Attributes"}],"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":{"/schema/ws/{workspace-id}/trafficTypes/{traffic-type-id}":{"post":{"summary":"Save Attribute","description":"Save an attribute for a traffic type ID. The attribute is created if it does not exist, and is overwritten completely with the provided attribute object if it does. This endpoint also accepts a PUT that behaves identically to the POST, but the POST is preferred. Use the PATCH endpoint for partial updates. 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":"save-attribute","parameters":[{"name":"Authorization","in":"header","description":"Required Admin API key.","schema":{"type":"string","default":"Bearer ADMIN_API_KEY"},"required":false},{"name":"Content-Type","in":"header","description":"Defaults to application/json.","schema":{"type":"string","default":"application/json"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) you want to add attributes to. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The traffic type ID associated with the attribute"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"RAW_BODY":{"type":"string","description":"The endpoint lists a `RAW_BODY` form field, which implies `application/x-www-form-urlencoded` content. It should instead be defined as a raw JSON body with `Content-Type: application/json`.","default":"{   \"id\": \"anAttribute\",   \"displayName\": \"An Attribute\",   \"description\": \"my description here\",   \"dataType\": \"string\",   \"suggestedValues\": [     \"suggested\",     \"values\"   ]  }"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Attributes"]}}}}
```

## Bulk Upload Attribute via JSON

> Bulk upload attributes. If an attribute already exists, it is replaced. This endpoint accepts a JSON upload. If there is an issue parsing any of the attributes, an error is thrown and attributes with issues are sent back with error messages. 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":"Attributes"}],"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":{"/schema/ws/{workspace-id}/trafficTypes/{traffic-type-id}/attribute:bulk":{"post":{"summary":"Bulk Upload Attribute via JSON","description":"Bulk upload attributes. If an attribute already exists, it is replaced. This endpoint accepts a JSON upload. If there is an issue parsing any of the attributes, an error is thrown and attributes with issues are sent back with error messages. 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":"bulk-save-attribute-via-json","parameters":[{"name":"Content-Type","in":"header","schema":{"type":"string","default":"application/json"}},{"name":"Authorization","in":"header","schema":{"type":"string","default":"Bearer ADMIN_API_KEY"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The project (workspace) associated with the attribute. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The traffic type ID associated with the attribute"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"RAW_BODY":{"type":"string","default":"[   {     \"id\": \"anAttribute\",     \"organizationId\": \"orgId\",     \"trafficTypeId\": \"trafficTypeId\",     \"displayName\": \"An Attribute\",     \"description\": \"my description here\",     \"dataType\": \"string\",     \"suggestedValues\": [         \"suggested\",         \"values\"     ]   }  ]"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Attributes"]}}}}
```

## Delete Attribute

> Delete an attribute schema by its traffic type and attribute ID. This removes any stored data for that attribute from all Identities (keys) in the Split application. The change to Identity keys is processed asynchronously for traffic types with many Identities it may take up to a minute. However, the Attribute delete occurs synchronously, and if the http call returns as a success (2XX), then the attribute is successfully deleted.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Attributes"}],"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":{"/schema/ws/{workspace-id}/trafficTypes/{traffic-type-id}/{attribute-id}":{"delete":{"summary":"Delete Attribute","description":"Delete an attribute schema by its traffic type and attribute ID. This removes any stored data for that attribute from all Identities (keys) in the Split application. The change to Identity keys is processed asynchronously for traffic types with many Identities it may take up to a minute. However, the Attribute delete occurs synchronously, and if the http call returns as a success (2XX), then the attribute is successfully deleted.","operationId":"delete-attribute","parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","default":"Bearer ADMIN_API_KEY"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The ID of the project (workspace) to delete the attribute from. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The traffic type ID associated with the attribute"},{"in":"path","name":"attribute-id","schema":{"type":"string"},"required":true,"description":"The ID of the attribute to delete"}],"responses":{"202":{"description":"202","content":{"application/json":{"schema":{"type":"boolean","default":true}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Attributes"]}}}}
```

## Update Attribute

> Partial update of an attribute. Any fields not sent in the body cause no changes, fields sent as null in the body remove them from the attribute.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Attributes"}],"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":{"/schema/ws/{workspace-id}/trafficTypes/{traffic-type-id}/{attribute-id}":{"patch":{"summary":"Update Attribute","description":"Partial update of an attribute. Any fields not sent in the body cause no changes, fields sent as null in the body remove them from the attribute.","operationId":"update-attribute","parameters":[{"name":"Authorization","in":"header","schema":{"type":"string","default":"Bearer ADMIN_API_KEY"}},{"in":"path","name":"workspace-id","schema":{"type":"string"},"required":true,"description":"The project (workspace) associated with the attribute. After migration to Harness, get this value using the [Get Projects (Workspaces)](https://docs.split.io/reference/get-workspaces#/) endpoint and the Harness project name."},{"in":"path","name":"traffic-type-id","schema":{"type":"string"},"required":true,"description":"The traffic type ID associated with the attribute"},{"in":"path","name":"attribute-id","schema":{"type":"string"},"required":true,"description":"The ID of attribute to update"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"RAW_BODY":{"type":"string","default":"{   \"displayName\": \"An Attribute\",   \"description\": \"my description here\",   \"dataType\": \"string\",   \"suggestedValues\": [     \"suggested\",     \"values\"   ]  }"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Attributes"]}}}}
```
