Get Tasks By Batch Id
Get optimized task batch details with job statistics grouped by TaskBlueprintJob. Returns aggregated job counts for each TaskBlueprintJob type within the batch.
HTTPBearerAuthorizationBearer <token>batch_id*Batch IdSuccessful Response
application/json- response
Detailed view of a task batch with job summaries grouped by TaskBlueprintJob
data*array<>batch_id*Batch Idbatch_title*Batch Titlebatch_title_source*TaskBatchTitleSourceProvenance of a :class:TaskBatch title, in ascending precedence.
Stored as a plain string column (not a DB enum) — mirrors
LayoutVersionStatus: this StrEnum is the Python-side source of truth
for the allowed values; readers coerce at the read site
(TaskBatchTitleSource(row.title_source)). Precedence
(manual > ai_final > ai_start > fallback) lives in
copyhero_base.service.import_title.resolve_batch_title_write — a
lower-precedence source may never overwrite a higher one (exec-plan
import-batch-titles, "Title precedence").
"fallback""ai_start""ai_final""manual"blueprint_name?string|nullblueprint_description?string|nullstore_name?string|nulltask_count*Task Countcompleted_tasks?Completed Tasks0failed_tasks?Failed Tasks0running_tasks?Running Tasks0pending_tasks?Pending Tasks0cancelled_tasks?Cancelled Tasks0created_at*Created Atdate-timeupdated_at*Updated Atdate-timefirst_job_started_at?|nulllast_job_finished_at?|nullorigin?Origin"manual""manual""webhook""monday"monday_trigger_id?integer|nullmonday_trigger_name?string|nullmonday_trigger?|nullfollow_up_total?Follow Up Total0follow_up_failed?Follow Up Failed0follow_up_failure_reasons?{}curl -X GET 'https://app.copyhero.app/api/v1/tasks/batch/0'{ "data": [ { "blueprint_job_name": "string", "blueprint_job_description": "string", "failed_jobs": 0, "cancelled_jobs": 0, "finished_jobs": 0, "pending_jobs": 0, "running_jobs": 0 } ], "batch_id": 0, "batch_title": "string", "batch_title_source": "fallback", "blueprint_name": "string", "blueprint_description": "string", "store_name": "string", "task_count": 0, "completed_tasks": 0, "failed_tasks": 0, "running_tasks": 0, "pending_tasks": 0, "cancelled_tasks": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "first_job_started_at": "2019-08-24T14:15:22Z", "last_job_finished_at": "2019-08-24T14:15:22Z", "origin": "manual", "monday_trigger_id": 0, "monday_trigger_name": "string", "monday_trigger": { "id": 0, "name": "string", "board_id": "string", "event_type": "item_created", "column_id": "string", "column_value_filter": {}, "platform_filter": "string", "column_filters": [ { "column_id": "string", "operator": "eq", "value": "string" } ], "field_mapping": { "property1": { "mode": "column", "value": "string" }, "property2": { "mode": "column", "value": "string" } }, "deleted_at": "2019-08-24T14:15:22Z", "item_ids": [ "string" ], "triggered_at": "2019-08-24T14:15:22Z", "viewer_owns_trigger": true }, "follow_up_total": 0, "follow_up_failed": 0, "follow_up_failure_reasons": {}}Get Task Batches Paginated GET
Get paginated batch summaries with comprehensive filtering. Filters: - store_ids: Filter by one or more stores (OR within field). Repeated values: ?store_ids=12&store_ids=17 - blueprint_id: Filter by blueprint - batch_id: Filter by specific batch ID - owner_user_id: Runs of the organizations this user owns (superuser only; 403 otherwise) - created_after/before: Date range for batch creation - search_query: Search in blueprint/store names - state_filter: Filter by aggregate state (has_errors, all_complete, in_progress, cancelled) - sort_by: created_at, updated_at, task_count, batch_id - sort_order: asc or desc - skip: Pagination offset - limit: Pagination limit (1-100) Returns: TaskBatchesOut: Paginated batch summaries with total count
Preflight Task For Agent POST
Preflight one statically bounded external-agent workflow batch.