Runs

A Run represents a single execution of a task. Each time you execute a task, a new run is created to track status and results.

Execution Guide

For run states, polling patterns, error handling, and monitoring best practices, see the Execution guide.

Run Structure

{
  "id": "507f1f77bcf86cd799439014",
  "task_id": "507f1f77bcf86cd799439013",
  "icp_id": "507f1f77bcf86cd799439011",
  "task_type": "search",
  "flow_run_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "COMPLETED",
  "input": {
    "icp_id": "507f1f77bcf86cd799439011"
  },
  "output": {
    "version": "1.0",
    "credits": {
      "total_credits": 150.0,
      "breakdown": {
        "search_company": 100.0,
        "enrich_company": 50.0
      }
    },
    "resources": {
      "entities_created": ["entity_id_1", "entity_id_2"],
      "entities_updated": [],
      "signals_created": []
    },
    "run_time": 45.2
  },
  "error": null,
  "created_at": "2025-01-05T12:00:15Z",
  "updated_at": "2025-01-05T12:01:00Z"
}

Fields

Field	Type	Description
`id`	string	Unique run identifier
`task_id`	string	Parent task ID
`icp_id`	string	ICP used for this execution
`task_type`	string	Workflow type: `search`, `signal`, `profile`, `ingest`
`flow_run_id`	string	Internal workflow engine ID
`status`	string	Current state (see Execution)
`input`	object	Parameters passed at execution time
`output`	object	Results on completion (see Execution)
`error`	string	Error message if failed
`created_at`	datetime	When the run was created
`updated_at`	datetime	Last status update

Output Structure

When a run completes, the output field contains:

Field	Description
`credits.total_credits`	Total credits consumed
`credits.breakdown`	Credits by action type
`resources.entities_created`	IDs of new entities
`resources.entities_updated`	IDs of updated entities
`resources.signals_created`	IDs of new signals
`run_time`	Execution duration in seconds

Next Steps

Execution — Run states, polling, error handling
Tasks — Configure workflow templates
API Reference — Complete run endpoint documentation

Run Structure

Fields

Output Structure

Next Steps

On this page