# Conversations Attributes

Manage custom attributes for conversations

## List all conversation attributes

 - [GET /conversations/attributes](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/listconversationattributes.md): You can fetch a list of all conversation attributes for your workspace.

## Create a conversation attribute

 - [POST /conversations/attributes](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/createconversationattribute.md): Create a new conversation attribute.

## Get a conversation attribute

 - [GET /conversations/attributes/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/getconversationattribute.md): Retrieve a single conversation attribute by ID.

## Update a conversation attribute

 - [PUT /conversations/attributes/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/updateconversationattribute.md): Update an existing conversation attribute.

## Delete (archive) a conversation attribute

 - [DELETE /conversations/attributes/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/deleteconversationattribute.md): Archive a conversation attribute (soft delete). The attribute is marked as archived but not permanently deleted.

## Add an option to a list conversation attribute

 - [POST /conversations/attributes/{id}/options](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/createconversationattributeoption.md): Add a new option to a list-type conversation attribute. Returns the full attribute with the updated options array.

## Update an option on a list conversation attribute

 - [PUT /conversations/attributes/{id}/options/{option_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/updateconversationattributeoption.md): Update the label of a single option on a list-type conversation attribute. Returns the full attribute with the updated options array.

## Archive an option on a list conversation attribute

 - [DELETE /conversations/attributes/{id}/options/{option_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/conversations-attributes/deleteconversationattributeoption.md): Archive a single option on a list-type conversation attribute (soft delete). The option remains in the response with archived: true. Returns the full attribute with the updated options array.