Marketing intelligence,
inside your product.

Create a key in Q.Mind → Account → Developer API. Send a question to POST /api/v1/responses, then poll the returned Location until the status is terminal.

# Keep the key in your server environment.
export QMIND_API_KEY="qmind_live_…"

curl https://qmind.qdt.ai/api/v1/responses \
  -H "Authorization: Bearer $QMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: northstar-growth-001" \
  -d '{
    "input": "For fictional Northstar Laundry, should growth prioritize penetration or premiumization?",
    "capability": "cmo-counsel"
  }'

{
  "id": "9a4d…",
  "object": "qmind.response",
  "status": "queued",
  "model": "qmind-asimov",
  "conversation_id": "b71e…",
  "output_text": null,
  "links": { "self": "/api/v1/responses/9a4d…" }
}

Request fields

Save the returned conversation_id and send it on the next call. Q.Mind retrieves the account-scoped thread, project facts, prior answers, and governed evidence without asking your application to rebuild the prompt.

const followUp = await fetch(`${base}/responses`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.QMIND_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID()
  },
  body: JSON.stringify({
    input: "What evidence would falsify your first recommendation?",
    conversation_id: first.conversation_id
  })
});

Set processing_mode to analysis for deterministic governed work, or use auto for intent-based routing. Poll the same response; its progress object describes the current stage and elapsed work.

{
  "input": "Diagnose fictional Northstar Pet Nutrition. Return a PDF and editable PowerPoint.",
  "capability": "growth-diagnosis",
  "processing_mode": "analysis"
}

The progress fields are stage, label, detail, optional portfolio fields brand/current/total, and startedAt/updatedAt. Treat stage values as extensible.

Artifact types are qmind-report-pdf, qmind-report-pptx, qmind-creative-set, and qmind-campaign-calendar. Download URLs are stable authenticated paths, not expiring signed links; they remain valid while the artifact and authorized key remain active.

The response records canonical_answer_sha256 and canonical_integrity_verified; Q.Mind fails closed if its canonical answer changes in transit.

{
  "error": {
    "type": "invalid_request_error",
    "code": "conversation_not_found",
    "message": "The conversation does not exist in this account.",
    "param": "conversation_id"
  }
}