SYsymbol
import

Import CSV, Markdown or a Symbol export as typed capsules

Changed on
post/api/preview/import

Request

  • Base URL
    https://symbol.chat (the document declares no server; this is the origin it was published from)
  • URL
    https://symbol.chat/api/preview/import
  • Auth
    • HTTP bearer
    • or API key in cookie __Secure-next-auth.session-token
    • or OAuth 2
      Authorization code: https://mcp.symbol.chat/authorize
      Token URL: https://mcp.symbol.chat/token

Request body

format'csv' | 'markdown' | 'symbol' required
mark_incompleteboolean

Import rows that are missing required field values as incomplete capsules instead of skipping them.

source_type_slugstring

For a Symbol export carrying several Types: which of its Types this call imports.

target_type_idstring

Import into this existing Type.

type_slugsobject

For a Symbol export: the type_slugs analyze returned, passed unchanged on every call of the run (with type_slugs_sig). Required for an export whose manifest names several Types.

type_slugs_sigstring

Server signature over type_slugs, valid for 24 hours; pass it unchanged.

workspace_idstring nullable

UUID v4 string

Response

Successful response

createdinteger required
warningsstring[] required

Non-blocking notes, such as a reference between imported capsules that could not be rewritten.

Changes