S
ShipRepo
Sign in

Try the API in 30 seconds

Grab a free demo token — 2 tasks, public repos only, returns file-level insights (no fix, no PR). Upgrade any time for the full pipeline.

1. Get a demo token

2. Create your first task

curl -X POST https://api.shiprepo.com/v1/tasks \
  -H "Authorization: Bearer $SHIPREPO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repo_url": "https://github.com/expressjs/express",
    "prompt":   "find the file handling multipart uploads"
  }'

3. Stream results

curl -N https://api.shiprepo.com/v1/tasks/{id}/logs/stream \
  -H "Authorization: Bearer $SHIPREPO_TOKEN"

event: log
data: { "step": "planner", "status": "done", ... }

event: log
data: { "step": "locator", "status": "done", "output": { "keywords": ["multipart"], "top_hits": [...] } }

event: log
data: { "step": "inspector", "status": "done", "output": { "files": ["lib/express.js"], "root_cause": "..." } }

event: log
data: { "step": "demo", "status": "done", "output": { "note": "Demo run — upgrade for full fix + PR" } }

event: end
data: { "status": "done" }

Demo vs full

StageDemoFull (Starter+)
Planner
Locator
Inspector✓ (files + root_cause)
Fixer · Reviewer · Validator
Test sandbox run
Real GitHub PR
Tasks allowed2 per token50–250+ per month

When you hit the demo limit, go to pricing — one paid plan carries over the same token.

OpenAPI spec on GitHub

Drop the public spec into Postman, Insomnia, Scalar or openapi-generator:

curl https://shiprepo.com/openapi-public.yaml -o shiprepo.yaml
npx @openapitools/openapi-generator-cli generate -i shiprepo.yaml -g typescript-fetch -o sdk/

Interactive: api.shiprepo.com/docs