Welcome to the Deaimer platform.

The Deaimer API gives your engineering team programmatic access to Deaimer workflows — task ingestion, status callbacks, data delivery, and reporting. This documentation is the canonical reference for integrating Deaimer into your production AI stack.

If you're new to Deaimer, start with our Quickstart. If you're migrating from another data operations platform, see our Migration guide. For enterprise deployments with VPC or on-premises requirements, contact your solutions architect.

Authentication

All API requests are authenticated via bearer token. Your API keys are scoped to a specific workspace and can be restricted to specific workflows, roles, and IP ranges via the admin portal.

curl https://api.deaimer.com/v1/workflows \
  -H "Authorization: Bearer sk_live_..."

For production integrations, we strongly recommend using short-lived tokens via our OAuth 2.0 flow. SSO-authenticated users can also call the API using their session.

Quickstart

Create a workflow, submit tasks, and retrieve results in under five minutes.

from deaimer import Client

client = Client(api_key="sk_live_...")

# Create a workflow
workflow = client.workflows.create(
    name="Sentiment Labeling",
    task_type="classification",
    labels=["positive", "negative", "neutral"],
    qa_gates=["gold_set", "peer_review"],
)

# Submit tasks
tasks = client.tasks.submit(
    workflow_id=workflow.id,
    items=[{"text": "This product is great!"}, ...]
)

# Listen for completion via webhooks, or poll
for result in client.results.stream(workflow_id=workflow.id):
    print(result.label, result.confidence)

Workflows

A workflow is the top-level configuration for a project — it defines task types, routing rules, QA gates, SLAs, and delivery destinations. Workflows are declarative: you describe what you want, and the platform enforces it.

Workflows can be defined via the admin portal or programmatically via the API. For complex workflows, we recommend version-controlling workflow definitions in your own repository using our deaimer.yaml schema.

Webhooks

Receive real-time events for task completion, SLA breaches, QA failures, and delivery ready events. Configure webhook endpoints in your workspace admin, or programmatically via the API.

{
  "event": "task.completed",
  "workflow_id": "wf_abc123",
  "task_id": "tsk_xyz789",
  "result": {
    "label": "positive",
    "confidence": 0.94,
    "annotator_id": "ann_...",
    "qa_status": "approved"
  },
  "timestamp": "2026-04-21T14:32:11Z"
}

Webhook payloads are signed with HMAC-SHA256 using your webhook secret. Always verify signatures in production.

Support

Enterprise clients have access to a named Solutions Engineer and 24/7 priority support via email and Slack Connect. Community tier support is available via our contact form with business-day response.