RunDossier API

curl https://rundossier.com/api/v1/credits \
  -H "Authorization: Bearer dsk_live_your_key_here"

Authorization: Bearer dsk_live_...

{
  "error": {
    "code": "insufficient_credits",
    "message": "You have no credits remaining. Purchase more to continue."
  }
}

POST /dossiers

{
  "subject_name": "Jane Doe",
  "context": "VP of Engineering at Acme"
}

{
  "id": "b3f1c2a4-6d7e-4f89-a012-3456789abcde",
  "status": "pending"
}

GET /dossiers/{id}

{
  "id": "b3f1c2a4-6d7e-4f89-a012-3456789abcde",
  "status": "complete",
  "subject_name": "Jane Doe",
  "status_message": null,
  "error_message": null,
  "result_markdown": "# Jane Doe\n\n## Quick Facts\n...",
  "google_doc_url": "https://docs.google.com/document/d/abc123/edit",
  "word_doc_url": "https://dossier-bot-photos.s3.amazonaws.com/...&X-Amz-Expires=300",
  "photo_url": "https://dossier-bot-photos.s3.amazonaws.com/photos/jane-doe.jpg",
  "created_at": "2026-07-02T14:11:05.000Z",
  "duration_ms": 88213
}

{
  "id": "b3f1c2a4-6d7e-4f89-a012-3456789abcde",
  "status": "awaiting_selection",
  "subject_name": "Jane Doe",
  "status_message": "Multiple profiles found",
  "error_message": null,
  "result_markdown": null,
  "google_doc_url": null,
  "word_doc_url": null,
  "photo_url": null,
  "created_at": "2026-07-02T14:11:05.000Z",
  "duration_ms": null,
  "candidate_profiles": [
    {
      "url": "https://www.linkedin.com/in/janedoe",
      "title": "Jane Doe - VP Engineering - Acme",
      "headline": "VP Engineering at Acme",
      "location": "San Francisco, CA",
      "current_role": "VP Engineering",
      "current_company": "Acme"
    }
  ]
}

POST /dossiers/{id}/select

{
  "selected_url": "https://www.linkedin.com/in/janedoe"
}

{
  "id": "b3f1c2a4-6d7e-4f89-a012-3456789abcde",
  "status": "processing"
}

GET /dossiers

{
  "dossiers": [
    {
      "id": "b3f1c2a4-6d7e-4f89-a012-3456789abcde",
      "status": "complete",
      "subject_name": "Jane Doe",
      "error_message": null,
      "created_at": "2026-07-02T14:11:05.000Z",
      "duration_ms": 88213
    }
  ],
  "next_before": "2026-07-02T14:11:05.000Z"
}

GET /credits

{
  "monthly": 42,
  "topup": 10,
  "total": 52
}

export DOSSIER_API_KEY="dsk_live_your_key_here"

# 1. Create a dossier
curl -X POST https://rundossier.com/api/v1/dossiers \
  -H "Authorization: Bearer $DOSSIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject_name": "Jane Doe", "context": "VP of Engineering at Acme"}'
# → 201 { "id": "b3f1c2a4-...", "status": "pending" }

# 2. Poll until the status is complete or error
curl https://rundossier.com/api/v1/dossiers/b3f1c2a4-... \
  -H "Authorization: Bearer $DOSSIER_API_KEY"
# → { "status": "processing", ... }  then eventually
# → { "status": "complete", "result_markdown": "# Jane Doe...", ... }

const BASE = "https://rundossier.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.DOSSIER_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Create
const created = await fetch(`${BASE}/dossiers`, {
  method: "POST",
  headers,
  body: JSON.stringify({ subject_name: "Jane Doe", context: "VP of Engineering at Acme" }),
});
if (!created.ok) throw new Error(`Create failed: ${created.status}`);
const { id } = await created.json();

// 2. Poll until a terminal state
async function poll(id) {
  while (true) {
    const res = await fetch(`${BASE}/dossiers/${id}`, { headers });
    const d = await res.json();
    if (d.status === "complete") return d;
    if (d.status === "error") throw new Error(d.error_message ?? "Generation failed");
    if (d.status === "awaiting_selection") {
      // Pick the best candidate (or surface d.candidate_profiles to a human)
      await fetch(`${BASE}/dossiers/${id}/select`, {
        method: "POST",
        headers,
        body: JSON.stringify({ selected_url: d.candidate_profiles[0].url }),
      });
    }
    await new Promise((r) => setTimeout(r, 5000));
  }
}

const dossier = await poll(id);
console.log(dossier.result_markdown);

import os, time, requests

BASE = "https://rundossier.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DOSSIER_API_KEY']}"}

# 1. Create
resp = requests.post(
    f"{BASE}/dossiers",
    headers=HEADERS,
    json={"subject_name": "Jane Doe", "context": "VP of Engineering at Acme"},
)
resp.raise_for_status()
dossier_id = resp.json()["id"]

# 2. Poll until a terminal state
while True:
    d = requests.get(f"{BASE}/dossiers/{dossier_id}", headers=HEADERS).json()
    if d["status"] == "complete":
        break
    if d["status"] == "error":
        raise RuntimeError(d.get("error_message", "Generation failed"))
    if d["status"] == "awaiting_selection":
        requests.post(
            f"{BASE}/dossiers/{dossier_id}/select",
            headers=HEADERS,
            json={"selected_url": d["candidate_profiles"][0]["url"]},
        )
    time.sleep(5)

print(d["result_markdown"])

GET /api/v1/openapi.json