# geni crm tags (/cli/crm/tags) Tags are state labels on people or companies (e.g. Customer, Prospect). With no verb, `geni crm tags` lists them; the verb subcommands create, update, delete, and assign or unassign them to records. ## list (default) [#list-default] ```sh geni crm tags --type person ``` List the workspace tags. Filter to one kind with `--type`. | Flag | Notes | | --------------- | -------------------------------- | | `--type ` | Only `person` or `company` tags. | | `--json` | Machine-readable output. | ## create [#create] ```sh geni crm tags create --json '{"name":"Customer","entityType":"company","color":"green"}' ``` Create a tag. `--json` is `{ name, entityType: person|company, color? }`. | Flag | Notes | | --------------- | ------------------------------ | | `--json ` | Required. JSON tag definition. | ## update [#update] ```sh geni crm tags update tag_01HX --json '{"color":"blue"}' ``` Update a tag. `--json` is `{ name?, color? }`. | Arg / Flag | Notes | | --------------- | -------------------------------- | | `` | Tag id. | | `--json ` | Required. JSON fields to change. | ## delete [#delete] ```sh geni crm tags delete tag_01HX ``` Delete a tag. | Arg | Notes | | ------ | ------- | | `` | Tag id. | ## assign [#assign] ```sh geni crm tags assign tag_01HX cmp_01HX cmp_01HY ``` Assign a tag to people or companies. The ids must match the tag's entity type. | Arg | Notes | | ---------------- | ----------------------------- | | `` | Tag id. | | `` | Person or company ids to tag. | ## unassign [#unassign] ```sh geni crm tags unassign tag_01HX cmp_01HX ``` Remove a tag from one record. | Arg | Notes | | ------------ | ------------------------------ | | `` | Tag id. | | `` | Person or company id to untag. |