# pin_style

> Pin a style to a brand with Wavegrain's MCP server: the pin_style tool needs the write permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Pin a style to a brand.** Permission: `write`. Changes saved work.

Pin a tailored style to a brand, so posts of its purpose use it when no style is named. Answers the brand's pinned styles.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `brandId` | string | yes | A brand id from list_brands. up to 200 characters |
| `styleId` | string | yes | A style id from list_styles. up to 200 characters |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `brandId` | string | The brand. |
| `pinned` | object[] | The brand's pinned styles after this call. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `write` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pin_style",
    "arguments": {
      "brandId": "<brandId>",
      "styleId": "<styleId>"
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`create_style`](/developers/mcp-tools/create_style): Create a tailored style
- [`edit_style`](/developers/mcp-tools/edit_style): Edit a tailored style
- [`copy_style`](/developers/mcp-tools/copy_style): Copy a tailored style
- [`unpin_style`](/developers/mcp-tools/unpin_style): Unpin a style from a brand
- [`create_upload`](/developers/mcp-tools/create_upload): Upload an image
- [`edit_tailored_slideshow`](/developers/mcp-tools/edit_tailored_slideshow): Edit a tailored slideshow
- [All 79 tools](/developers/mcp-tools)
