Documentation Index
Fetch the complete documentation index at: https://docs.manticscore.com/llms.txt
Use this file to discover all available pages before exploring further.
ManticScore integrates with Slack and Notion so your research and build output reaches your team automatically. You can post a research summary to a Slack channel the moment analysis completes, export a build plan as a structured Notion page, or configure per-channel routing for different types of ManticScore events. Both integrations support one-tap export and event-driven automations.
Connecting
Connect Slack through the Composio OAuth flow:curl -X POST https://api.manticscore.com/profile/integrations/slack/connect \
-H "Authorization: Bearer <token>"
{
"url": "https://composio.dev/oauth/slack/...",
"toolkit": "slack"
}
curl -X PATCH https://api.manticscore.com/profile/integrations/slack/defaults \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "C1234",
"channel_name": "product",
"research_channel": "C5678",
"builds_channel": "C9012",
"signals_channel": "C3456",
"format": "summary",
"notify_on_research": true,
"notify_on_build": true,
"notify_on_signal": true
}'
| Field | Description |
|---|
channel_id / channel_name | Default channel for all exports |
research_channel | Override channel for research shares |
builds_channel | Override channel for build plan exports |
signals_channel | Override channel for competitive signal alerts |
format | Message format: summary (brief) or detailed (full breakdown) |
notify_on_research | Auto-post when research completes |
notify_on_build | Auto-post when a build graph is ready |
notify_on_signal | Auto-post when a new signal is detected |
List channels
curl https://api.manticscore.com/integrations/slack/channels \
-H "Authorization: Bearer <token>"
Post a message
curl -X POST https://api.manticscore.com/integrations/slack/messages \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"channel": "C1234",
"text": "Research for *Acme payments app* is ready."
}'
Connect Notion through the Composio OAuth flow:curl -X POST https://api.manticscore.com/profile/integrations/notion/connect \
-H "Authorization: Bearer <token>"
{
"url": "https://composio.dev/oauth/notion/...",
"toolkit": "notion"
}
curl -X PATCH https://api.manticscore.com/profile/integrations/notion/defaults \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"parent_id": "page-uuid",
"parent_title": "Product Research",
"research_db_id": "db-uuid-1",
"build_plan_db_id": "db-uuid-2"
}'
| Field | Description |
|---|
parent_id | Default parent page for new Notion exports |
parent_title | Human-readable label for the parent page |
research_db_id | Notion database to store research exports |
build_plan_db_id | Notion database to store build plan exports |
Search Notion
curl "https://api.manticscore.com/integrations/notion/search?q=product+research" \
-H "Authorization: Bearer <token>"
Create a page
curl -X POST https://api.manticscore.com/integrations/notion/pages \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"parent_id": "page-uuid",
"title": "Payments app build plan",
"content": "## Overview\nThis plan covers authentication, billing, and reporting."
}'
Sharing research
Use POST /research/{job_id}/share to export completed research to Slack, Notion, or email in one call.
Share to Slack
Export to Notion
curl -X POST https://api.manticscore.com/research/job-uuid/share \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"target": "slack",
"channel": "C1234",
"format": "summary"
}'
{
"sent": true,
"channel": "C1234"
}
channel to use your configured default. Set format to detailed for the full research breakdown.curl -X POST https://api.manticscore.com/research/job-uuid/share \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"target": "notion",
"parent_id": "page-uuid"
}'
{
"page": {
"id": "notion-page-uuid",
"url": "https://www.notion.so/notion-page-uuid"
}
}
parent_id to use your configured default.Shipping a build plan
Use POST /build-graphs/{graph_id}/ship to export an entire build graph to Slack or Notion.
Ship to Slack
Ship to Notion
curl -X POST https://api.manticscore.com/build-graphs/graph-uuid/ship \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "target": "slack" }'
{
"target": "slack",
"sent": true,
"channel": "C9012",
"format": "summary"
}
builds_channel and format defaults. Pass channel and format in the request body to override them.curl -X POST https://api.manticscore.com/build-graphs/graph-uuid/ship \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "target": "notion" }'
{
"target": "notion",
"page": {
"id": "notion-page-uuid",
"url": "https://www.notion.so/notion-page-uuid"
}
}
Exporting a single build node to Notion
You can export one build node as a structured Notion page with its objective, acceptance criteria, and test checklist.
curl -X POST https://api.manticscore.com/build-nodes/node-uuid/doc \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"target": "notion",
"parent_id": "page-uuid"
}'
{
"node_id": "node-uuid",
"target": "notion",
"page": {
"id": "notion-page-uuid",
"url": "https://www.notion.so/notion-page-uuid"
}
}
Omit parent_id to use your configured Notion default page. ManticScore structures the exported page with sections for the node’s objective, constraints, acceptance criteria, and test checklist.
Both /research/{id}/share and /build-graphs/{id}/ship return 400 if the target integration is not connected, or if a required field (such as a channel or parent page) is missing from both the request and your saved defaults.