Tasks & Artifacts

Tasks

A Task is an async unit of work dispatched to an agent. Every task has:

• task_type — what the agent should do (e.g., ai_readiness.full_audit)
• input — validated against the agent's manifest schema
• status — pending → running → complete / failed / cancelled
• artifacts — typed outputs produced when the task completes

Task Lifecycle

pending → running → complete
                 ↘ failed
                 ↘ cancelled

Tasks are dispatched asynchronously. Use the Tasks API to poll status or register a webhook for completion events.

Triggering a Task

Tasks can be started via:

• Dashboard — click Run Task on any agent
• API — POST /v1/tasks
• Schedule — cron-based recurring tasks
• Event — triggered by another agent's artifact or an external webhook
• Channel — triggered by a Slack message or email

Artifacts

An Artifact is a typed, structured output produced by a task. Artifacts are immutable once created.

Common Artifact Types

Agent	Artifact Type	Description
AI Readiness	ai_readiness.audit_report	Full EU AI Act compliance gap report
AI Readiness	ai_readiness.questionnaire_response	Draft answers to procurement questionnaires
Sales	sales.lead_list	Discovered leads with company metadata
Sales	sales.enriched_lead_list	Leads with verified email contacts
Sales	sales.email_draft	Personalized outreach email, pending approval
Sales	sales.pipeline_report	Reply tracking and conversion summary

Fetching an Artifact

curl https://api.ariftly.io/v1/artifacts/art_001 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "artifact_id": "art_001",
  "task_id": "task_xyz789",
  "type": "ai_readiness.audit_report",
  "created_at": "2026-04-23T10:04:22Z",
  "data": {
    "gaps_found": 14,
    "critical": 3,
    "eu_ai_act_score": 62,
    "recommendations": ["..."]
  }
}