Skip to main content

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.

The Ship API provides one-tap export endpoints that use your auto-discovered integration defaults so you don’t have to pass configuration on every call. Ship a build graph to Linear and it bulk-creates issues for every node. Ship to GitHub and it kicks off a Forge agentic coding run. Share research to Slack and it posts a formatted summary to your configured channel. If you need to override a default for a specific call, pass the optional fields; otherwise the server uses whatever was discovered when you connected the toolkit.

​
Ship a build graph

Exports the entire build plan to a connected integration. All optional fields fall back to auto-discovered defaults if omitted.
​
target
string
required
The integration to ship to. One of: linear, jira, slack, notion, github.
​
team_id
string
Linear team ID. Falls back to your configured Linear default if omitted.
​
project_key
string
Jira project key (e.g. ENG). Falls back to your configured Jira default if omitted.
​
channel
string
Slack channel ID. Falls back to your configured builds_channel default if omitted.
​
repo
string
GitHub repository in owner/repo format. Falls back to your configured GitHub default if omitted. Required for github target.
​
top_level_only
boolean
default:"false"
When true, only the root-level nodes are exported. Useful for creating high-level epics without sub-tasks.
curl -X POST "https://api.manticscore.com/build-graphs/5b2c8f3d-.../ship" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"target": "linear"}'

​
Responses by target

200 response
{
  "target": "linear",
  "total": 12,
  "created": 12,
  "issues": [
    {
      "node_id": "n1a2b3c4-...",
      "node": "Authentication module",
      "effort": "medium",
      "priority": 2
    }
  ]
}
​
total
number
Total build nodes processed.
​
created
number
Issues successfully created in the target system.
​
issues
object[]
Returns 400 if the target is not connected, no defaults are configured and the required field was not provided, or the target value is unrecognized. Connect the integration and configure its defaults before calling this endpoint.

​
Share research

Exports a completed research job to Slack, Notion, or email. You can also create a public share link using POST /research/{job_id}/share with no body.
​
target
string
required
Destination for the export: slack, notion, or email.
​
channel
string
Slack channel ID. Falls back to your configured research_channel default. Required for target: slack if no default is set.
​
parent_id
string
Notion parent page or database ID. Falls back to your configured research_db_id default. Required for target: notion if no default is set.
​
to
string
Recipient email address. Required for target: email.
​
format
string
Export format: summary or detailed. Falls back to your configured Slack format default. Defaults to summary if not set anywhere.
curl -X POST "https://api.manticscore.com/research/7c3d1e9a-.../share" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"target": "slack", "format": "detailed"}'

​
Responses by target

200 response
{
  "sent": true,
  "channel": "C01234567"
}
Returns 400 if the target is not connected or a required field is missing. Returns 404 if the research job is not found or has not completed yet.
Publishes research as a public App Clip page and returns a shareable URL. Anyone with the link can view the research without logging in. 
curl -X POST "https://api.manticscore.com/research/7c3d1e9a-.../share" \
  -H "Authorization: Bearer <token>"
200 response
{
  "share_token": "tok_abc123...",
  "share_url": "https://manticscore.com/clip/research-abc123"
}
​
share_token
string
Opaque token that identifies this share. Pass it to DELETE /research/{job_id}/share to revoke access.
​
share_url
string
Public URL anyone can open to read the research. No authentication required.
Only completed research can be shared. The server returns 400 if the job is still running or has failed.
To revoke a public share link:
curl
curl -X DELETE "https://api.manticscore.com/research/7c3d1e9a-.../share" \
  -H "Authorization: Bearer <token>"
Returns {"revoked": true} on success.