---
title: "Resolve @slug capsule and Type mentions in a single round-trip"
method: POST
path: "/api/preview/mentions/resolve"
tags: ["mention"]
---

# Resolve @slug capsule and Type mentions in a single round-trip

`POST /api/preview/mentions/resolve`

## Query parameters

- `ws` string — Optional workspace context for the request. Same value rules as the MCP `workspace` tool argument. Omit to use the caller's default workspace.

## Request body

- object
  - `include_images` boolean — Whether to inline image attachment payloads in the response.
  - `mentions` object — Pre-parsed mention map. Optional companion to `prompt`; the route accepts either or both.
    - `capsules` string[] — Explicit capsule references in `slug/N` form.
    - `projects` string[] — Project references — `#slug` or `@project:slug`. A project reference must be the only mention in the request; mixing it with any other reference is rejected.
    - `types` string[] — Whole-Type references — bare `@slug`.
  - `prompt` string — Free-form text containing @slug/N or @slug references to resolve.
  - `shape` 'mcp' | 'wide' — Output shape. `mcp` = compact agent-facing projection; `wide` = full envelope (default).
  - `type_capsule_limit` integer — Cap on capsules returned per resolved Type mention. 1–100; defaults server-side.
  - `workspaceId` string, nullable — Workspace context. `null` = personal workspace; UUID = a specific organization workspace; omit to resolve cross-workspace. Overridden by `?ws=` query param when present.

## Response `200`

Successful response

- object
  - `capsules` object, required
  - `meta` object
  - `parsed` object
  - `projects` object
  - `rejected` object, nullable
  - `types` object, required

---

[API](https://skmtc.net/symbol/apis/symbol-api.md) · [All operations](https://skmtc.net/symbol/apis/symbol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/symbol/symbol-api/revisions/c690ac22ae04/schema)