Developer

REST-API v1

Lies Artifacts aus, höre auf Events via Webhooks. Pro-Plan erforderlich. API-Key erstellst du in Settings → Developer.

Authentifizierung

Alle Requests brauchen einen Bearer-Token im Authorization-Header:

curl https://startupbase.ai/api/v1/artifacts \
  -H "Authorization: Bearer sbk_live_..."

Endpoints

GET /api/v1/artifacts

Listet alle Artifacts im Workspace. Query-Parameter: kind, limit.

GET /api/v1/artifacts?kind=pitch_deck&limit=10

{
  "data": [
    {
      "id": "uuid",
      "kind": "pitch_deck",
      "title": "AWS Preseed Deck",
      "status": "ready",
      "version": 1,
      "created_at": "2026-04-22T10:00:00Z",
      "updated_at": "2026-04-22T10:05:00Z"
    }
  ],
  "meta": { "workspace_id": "uuid", "count": 1 }
}

Webhooks

Webhook-Endpoints legst du in Settings → Developer an. Beim Anlegen bekommst du ein Signing-Secret. Jeder Request hat die Signatur in X-Startupbase-Signature:

// Verify in Node.js
import { createHmac } from 'crypto';

function verify(body, signature, secret) {
  const expected = createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return expected === signature;
}

Events

  • artifact.created
  • artifact.updated
  • reminder.due
  • subscription.tier_changed
  • swarm_review.completed
  • outreach.message_opened
  • outreach.message_replied

Rate-Limits

60 Requests/Minute pro API-Key. Überschreitung → 429 Too Many Requests.

Support

Fragen? Schreib an hello@startupbase.ai.