# Pins

A pin is your own shortcut to a ticket, project, product, environment or team, listed in the website's sidebar in your order.

A pin is your own shortcut to a ticket, project, product, environment or team. The website's
sidebar lists your pins under **Pinned**, in your order, and only you see them. An agent you work
with changes your pins too, such as pinning the ticket it is working on. A change shows at once in
every website tab you have open.

## What a pin names

A pin names what it points at by kind and key: the key is what the thing's pages use.

| Kind          | Key                                     | Example       |
| ------------- | --------------------------------------- | ------------- |
| `ticket`      | The ticket's ID; a former ID also works | `WEB-31`      |
| `project`     | The project's slug                      | `docs-launch` |
| `product`     | The product's slug                      | `storefront`  |
| `environment` | The environment's slug                  | `staging`     |
| `team`        | The team's key                          | `WEB`         |

Pinning something already pinned changes nothing, and an archived thing cannot be pinned. Pins of
archived things, and of things you can no longer see, leave your list. A ticket that moves to
another team keeps its pin under its new ID.

Pins belong to a person, so an account API key cannot read or change them. Use a personal API key,
the CLI's sign-in, or an agent working for you.

## Every surface

| Operation       | API (`/v1/workspaces/{slug}`)       | MCP                                   | CLI                  |
| --------------- | ----------------------------------- | ------------------------------------- | -------------------- |
| List your pins  | [List your pins](https://docs.qa.clankership.net/api/pins/list.md)    | [list_pins](https://docs.qa.clankership.net/mcp/tools/list_pins.md)     | `clanker pin list`   |
| Pin something   | [Pin something](https://docs.qa.clankership.net/api/pins/create.md)   | [create_pin](https://docs.qa.clankership.net/mcp/tools/create_pin.md)   | `clanker pin add`    |
| Unpin something | [Unpin something](https://docs.qa.clankership.net/api/pins/delete.md) | [delete_pin](https://docs.qa.clankership.net/mcp/tools/delete_pin.md)   | `clanker pin remove` |
| Reorder a pin   | [Reorder a pin](https://docs.qa.clankership.net/api/pins/reorder.md)  | [reorder_pin](https://docs.qa.clankership.net/mcp/tools/reorder_pin.md) | `clanker pin move`   |

On the website, pin a ticket with the pin beside its title, and anything else from its page's
**More** menu. Drag a row in the sidebar to move it.

## CLI

```bash
clanker pin add ticket WEB-31
clanker pin add project docs-launch
clanker pin move ticket WEB-31 --before project:docs-launch
clanker pin list
clanker pin remove ticket WEB-31
```

Each command prints your pins in their order as JSON.