Prism API
Use API keys to call common Prism research endpoints or the generic tool API over JSON.
The Prism API is a JSON surface over the same scoped research tools used by Prism MCP. API keys are separate from MCP tokens and are shown once when created.
Workflow
Primary steps
- 1Create a Prism API key from the signed-in MCP & API dashboard.
- 2Send the key as an Authorization bearer token to /api/v1 routes.
- 3Use REST endpoints for common reads or /api/v1/tools/{toolName} for the complete scoped tool surface.
Authentication
Create an API key in the signed-in MCP & API dashboard, store it as a secret, and send it as Authorization: Bearer prism_api_...
MCP tokens do not authenticate API requests, and API keys do not authenticate MCP clients.
Endpoints
Common routes include /api/v1/workspace/context, /api/v1/projects/search?q=..., /api/v1/projects/content-chunks/{chunkId}, POST /api/v1/projects/folders, POST /api/v1/projects/media, GET/PATCH /api/v1/projects/files/{fileId}, PUT /api/v1/projects/files/{fileId}/media, POST /api/v1/projects/youtube-transcripts/preview, POST /api/v1/projects/youtube-transcripts, /api/v1/projects/chunks/search?q=..., /api/v1/companies/{ticker}/context, /api/v1/articles/drafts, /api/v1/articles/posts?q=...&status=published&limit=50, and /api/v1/portfolios.
YouTube transcript routes support an optional availability preview for API and agent workflows. Import matches the one-step in-app flow: it saves a private video source with an in-app player, then queues search indexing in the background. Repeated default-language imports of the same video into one Project reuse the existing source. They do not download audio or create MP3 files.
Supported local PDFs, documents, spreadsheets, images, MP3 audio, and videos can be uploaded through POST /api/v1/tools/upload_library_file_source with an explicit contentCategory, MIME type, and base64 payload. This uses the generic tool API; no separate REST file-upload endpoint or remote-file fetch is provided.
Posted article lists support q, status, visibility, linkedTicker, linkedCompanyId, limit, and sort filters.
For the complete scoped surface, call POST /api/v1/tools/{toolName} with { input: { ... } }. Responses return { data, meta }.
Write boundaries
Write tools are available only when Prism write tools are enabled for the deployment and the API key has the matching write scope.
API writes follow Prism's MCP boundaries: no public publishing, external-agent scheduling or execution, deletion outside exposed tools, subscriber emails, real brokerage trades, or bypassing review surfaces.