Files
a2a-platform dfb65e705f deploy
2026-06-06 21:16:45 +00:00

20 KiB

name, description
name description
actor-tasks-routes Handle 49 OpenAPI operation(s) under /v2/actor-tasks for the actor tasks route group.

actor tasks API Routes

Handle 49 OpenAPI operation(s) under /v2/actor-tasks for the actor tasks route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

actor_tasks_get

  • Operation ID: actor_tasks_get
  • Route: GET /v2/actor-tasks
  • Mode: READ
  • Summary: Get list of tasks
  • Parameters:
    • offset in query
    • limit in query
    • desc in query

actor_tasks_post

  • Operation ID: actor_tasks_post
  • Route: POST /v2/actor-tasks
  • Mode: WRITE
  • Summary: Create task
  • Body: JSON request body accepted.

actor_task_get

  • Operation ID: actor_task_get
  • Route: GET /v2/actor-tasks/{actorTaskId}
  • Mode: READ
  • Summary: Get task
  • Parameters:
    • actorTaskId in path required

actor_task_put

  • Operation ID: actor_task_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}
  • Mode: WRITE
  • Summary: Update task
  • Parameters:
    • actorTaskId in path required
  • Body: JSON request body accepted.

actor_task_delete

  • Operation ID: actor_task_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}
  • Mode: WRITE
  • Summary: Delete task
  • Parameters:
    • actorTaskId in path required

actor_task_input_get

  • Operation ID: actor_task_input_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/input
  • Mode: READ
  • Summary: Get task input
  • Parameters:
    • actorTaskId in path required

actor_task_input_put

  • Operation ID: actor_task_input_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/input
  • Mode: WRITE
  • Summary: Update task input
  • Parameters:
    • actorTaskId in path required
  • Body: JSON request body accepted.

actor_task_webhooks_get

  • Operation ID: actor_task_webhooks_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/webhooks
  • Mode: READ
  • Summary: Get list of webhooks
  • Parameters:
    • actorTaskId in path required
    • offset in query
    • limit in query
    • desc in query

actor_task_runs_get

  • Operation ID: actor_task_runs_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs
  • Mode: READ
  • Summary: Get list of task runs
  • Parameters:
    • actorTaskId in path required
    • offset in query
    • limit in query
    • desc in query
    • status in query

actor_task_runs_post

  • Operation ID: actor_task_runs_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs
  • Mode: WRITE
  • Summary: Run task
  • Parameters:
    • actorTaskId in path required
    • timeout in query
    • memory in query
    • maxItems in query
    • maxTotalChargeUsd in query
    • restartOnError in query
    • build in query
    • waitForFinish in query
    • webhooks in query
  • Body: JSON request body accepted.

actor_task_run_sync_get

  • Operation ID: actor_task_run_sync_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/run-sync
  • Mode: READ
  • Summary: Run task synchronously
  • Parameters:
    • actorTaskId in path required
    • timeout in query
    • memory in query
    • maxItems in query
    • build in query
    • outputRecordKey in query
    • webhooks in query

actor_task_run_sync_post

  • Operation ID: actor_task_run_sync_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/run-sync
  • Mode: WRITE
  • Summary: Run task synchronously
  • Parameters:
    • actorTaskId in path required
    • timeout in query
    • memory in query
    • maxItems in query
    • maxTotalChargeUsd in query
    • restartOnError in query
    • build in query
    • outputRecordKey in query
    • webhooks in query
  • Body: JSON request body accepted.

actor_task_run_sync_get_dataset_items_get

  • Operation ID: actor_task_run_sync_get_dataset_items_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/run-sync-get-dataset-items
  • Mode: READ
  • Summary: Run task synchronously and get dataset items
  • Parameters:
    • actorTaskId in path required
    • timeout in query
    • memory in query
    • maxItems in query
    • build in query
    • webhooks in query
    • format in query
    • clean in query
    • offset in query
    • limit in query
    • fields in query
    • outputFields in query
    • omit in query
    • unwind in query
    • flatten in query
    • desc in query
    • attachment in query
    • delimiter in query
    • bom in query
    • xmlRoot in query
    • xmlRow in query
    • skipHeaderRow in query
    • skipHidden in query
    • skipEmpty in query
    • simplified in query
    • view in query
    • skipFailedPages in query
    • feedTitle in query
    • feedDescription in query

actor_task_run_sync_get_dataset_items_post

  • Operation ID: actor_task_run_sync_get_dataset_items_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/run-sync-get-dataset-items
  • Mode: WRITE
  • Summary: Run task synchronously and get dataset items
  • Parameters:
    • actorTaskId in path required
    • timeout in query
    • memory in query
    • maxItems in query
    • maxTotalChargeUsd in query
    • restartOnError in query
    • build in query
    • webhooks in query
    • format in query
    • clean in query
    • offset in query
    • limit in query
    • fields in query
    • outputFields in query
    • omit in query
    • unwind in query
    • flatten in query
    • desc in query
    • attachment in query
    • delimiter in query
    • bom in query
    • xmlRoot in query
    • xmlRow in query
    • skipHeaderRow in query
    • skipHidden in query
    • skipEmpty in query
    • simplified in query
    • view in query
    • skipFailedPages in query
    • feedTitle in query
    • feedDescription in query
  • Body: JSON request body accepted.

actor_task_runs_last_get

  • Operation ID: actor_task_runs_last_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last
  • Mode: READ
  • Summary: Get last run
  • Parameters:
    • actorTaskId in path required
    • status in query
    • waitForFinish in query

actor_task_last_log_get

  • Operation ID: actor_task_last_log_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/log
  • Mode: READ
  • Summary: Get last Actor task run's log
  • Parameters:
    • actorTaskId in path required
    • stream in query
    • download in query
    • raw in query

actor_task_runs_last_abort_post

  • Operation ID: actor_task_runs_last_abort_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/abort
  • Mode: WRITE
  • Summary: Abort Actor task's last run
  • Parameters:
    • actorTaskId in path required
    • status in query
    • gracefully in query

actor_task_runs_last_metamorph_post

  • Operation ID: actor_task_runs_last_metamorph_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/metamorph
  • Mode: WRITE
  • Summary: Metamorph Actor task's last run
  • Parameters:
    • actorTaskId in path required
    • status in query
    • targetActorId in query required
    • build in query

actor_task_runs_last_reboot_post

  • Operation ID: actor_task_runs_last_reboot_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/reboot
  • Mode: WRITE
  • Summary: Reboot Actor task's last run
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_dataset_get

  • Operation ID: actor_task_runs_last_dataset_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/dataset
  • Mode: READ
  • Summary: Get last task run's default dataset
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_dataset_put

  • Operation ID: actor_task_runs_last_dataset_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/dataset
  • Mode: WRITE
  • Summary: Update last task run's default dataset
  • Parameters:
    • actorTaskId in path required
    • status in query
  • Body: JSON request body accepted.

actor_task_runs_last_dataset_delete

  • Operation ID: actor_task_runs_last_dataset_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/dataset
  • Mode: WRITE
  • Summary: Delete last task run's default dataset
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_dataset_items_get

  • Operation ID: actor_task_runs_last_dataset_items_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/dataset/items
  • Mode: READ
  • Summary: Get last task run's dataset items
  • Parameters:
    • actorTaskId in path required
    • status in query
    • format in query
    • clean in query
    • offset in query
    • limit in query
    • fields in query
    • outputFields in query
    • omit in query
    • unwind in query
    • flatten in query
    • desc in query
    • attachment in query
    • delimiter in query
    • bom in query
    • xmlRoot in query
    • xmlRow in query
    • skipHeaderRow in query
    • skipHidden in query
    • skipEmpty in query
    • simplified in query
    • view in query
    • skipFailedPages in query
    • feedTitle in query
    • feedDescription in query
    • signature in query

actor_task_runs_last_dataset_items_post

  • Operation ID: actor_task_runs_last_dataset_items_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/dataset/items
  • Mode: WRITE
  • Summary: Store items in last task run's dataset
  • Parameters:
    • actorTaskId in path required
    • status in query
  • Body: JSON request body accepted.

actor_task_runs_last_dataset_statistics_get

  • Operation ID: actor_task_runs_last_dataset_statistics_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/dataset/statistics
  • Mode: READ
  • Summary: Get last task run's dataset statistics
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_key_value_store_get

  • Operation ID: actor_task_runs_last_key_value_store_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store
  • Mode: READ
  • Summary: Get last task run's default store
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_key_value_store_put

  • Operation ID: actor_task_runs_last_key_value_store_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store
  • Mode: WRITE
  • Summary: Update last task run's default store
  • Parameters:
    • actorTaskId in path required
    • status in query
  • Body: JSON request body accepted.

actor_task_runs_last_key_value_store_delete

  • Operation ID: actor_task_runs_last_key_value_store_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store
  • Mode: WRITE
  • Summary: Delete last task run's default store
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_key_value_store_keys_get

  • Operation ID: actor_task_runs_last_key_value_store_keys_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/keys
  • Mode: READ
  • Summary: Get last task run's default store's list of keys
  • Parameters:
    • actorTaskId in path required
    • status in query
    • exclusiveStartKey in query
    • limit in query
    • collection in query
    • prefix in query
    • signature in query

actor_task_runs_last_key_value_store_records_get

  • Operation ID: actor_task_runs_last_key_value_store_records_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/records
  • Mode: READ
  • Summary: Download last task run's default store's records
  • Parameters:
    • actorTaskId in path required
    • status in query
    • collection in query
    • prefix in query
    • signature in query

actor_task_runs_last_key_value_store_record_get

  • Operation ID: actor_task_runs_last_key_value_store_record_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/records/{recordKey}
  • Mode: READ
  • Summary: Get last task run's default store's record
  • Parameters:
    • actorTaskId in path required
    • status in query
    • recordKey in path required
    • signature in query
    • attachment in query

actor_task_runs_last_key_value_store_record_put

  • Operation ID: actor_task_runs_last_key_value_store_record_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/records/{recordKey}
  • Mode: WRITE
  • Summary: Store record in last task run's default store
  • Parameters:
    • actorTaskId in path required
    • status in query
    • recordKey in path required
    • Content-Encoding in header
  • Body: JSON request body accepted.

actor_task_runs_last_key_value_store_record_post

  • Operation ID: actor_task_runs_last_key_value_store_record_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/records/{recordKey}
  • Mode: WRITE
  • Summary: Store record in last task run's default store (POST)
  • Parameters:
    • actorTaskId in path required
    • status in query
    • recordKey in path required
    • Content-Encoding in header
  • Body: JSON request body accepted.

actor_task_runs_last_key_value_store_record_delete

  • Operation ID: actor_task_runs_last_key_value_store_record_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/key-value-store/records/{recordKey}
  • Mode: WRITE
  • Summary: Delete last task run's default store's record
  • Parameters:
    • actorTaskId in path required
    • status in query
    • recordKey in path required

actor_task_runs_last_request_queue_get

  • Operation ID: actor_task_runs_last_request_queue_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/request-queue
  • Mode: READ
  • Summary: Get last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_request_queue_put

  • Operation ID: actor_task_runs_last_request_queue_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/request-queue
  • Mode: WRITE
  • Summary: Update last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
  • Body: JSON request body accepted.

actor_task_runs_last_request_queue_delete

  • Operation ID: actor_task_runs_last_request_queue_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/request-queue
  • Mode: WRITE
  • Summary: Delete last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query

actor_task_runs_last_request_queue_head_get

  • Operation ID: actor_task_runs_last_request_queue_head_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/head
  • Mode: READ
  • Summary: Get last task run's default request queue head
  • Parameters:
    • actorTaskId in path required
    • status in query
    • limit in query
    • clientKey in query

actor_task_runs_last_request_queue_head_lock_post

  • Operation ID: actor_task_runs_last_request_queue_head_lock_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/head/lock
  • Mode: WRITE
  • Summary: Get and lock last task run's default request queue head
  • Parameters:
    • actorTaskId in path required
    • status in query
    • lockSecs in query required
    • limit in query
    • clientKey in query

actor_task_runs_last_request_queue_requests_get

  • Operation ID: actor_task_runs_last_request_queue_requests_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests
  • Mode: READ
  • Summary: List last task run's default request queue's requests
  • Parameters:
    • actorTaskId in path required
    • status in query
    • clientKey in query
    • exclusiveStartId in query
    • limit in query
    • cursor in query
    • filter in query

actor_task_runs_last_request_queue_requests_post

  • Operation ID: actor_task_runs_last_request_queue_requests_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests
  • Mode: WRITE
  • Summary: Add request to last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • clientKey in query
    • forefront in query
  • Body: JSON request body accepted.

actor_task_runs_last_request_queue_requests_batch_post

  • Operation ID: actor_task_runs_last_request_queue_requests_batch_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/batch
  • Mode: WRITE
  • Summary: Batch add requests to last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • clientKey in query
    • forefront in query
  • Body: JSON request body accepted.

actor_task_runs_last_request_queue_requests_batch_delete

  • Operation ID: actor_task_runs_last_request_queue_requests_batch_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/batch
  • Mode: WRITE
  • Summary: Batch delete requests from last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • Content-Type in header required
    • clientKey in query
  • Body: JSON request body accepted.

actor_task_runs_last_request_queue_requests_unlock_post

  • Operation ID: actor_task_runs_last_request_queue_requests_unlock_post
  • Route: POST /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/unlock
  • Mode: WRITE
  • Summary: Unlock requests in last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • clientKey in query

actor_task_runs_last_request_queue_request_get

  • Operation ID: actor_task_runs_last_request_queue_request_get
  • Route: GET /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/{requestId}
  • Mode: READ
  • Summary: Get request from last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • requestId in path required

actor_task_runs_last_request_queue_request_put

  • Operation ID: actor_task_runs_last_request_queue_request_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/{requestId}
  • Mode: WRITE
  • Summary: Update request in last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • requestId in path required
    • forefront in query
    • clientKey in query
  • Body: JSON request body accepted.

actor_task_runs_last_request_queue_request_delete

  • Operation ID: actor_task_runs_last_request_queue_request_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/{requestId}
  • Mode: WRITE
  • Summary: Delete request from last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • requestId in path required
    • clientKey in query

actor_task_runs_last_request_queue_request_lock_put

  • Operation ID: actor_task_runs_last_request_queue_request_lock_put
  • Route: PUT /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/{requestId}/lock
  • Mode: WRITE
  • Summary: Prolong lock on request in last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • requestId in path required
    • lockSecs in query required
    • clientKey in query
    • forefront in query

actor_task_runs_last_request_queue_request_lock_delete

  • Operation ID: actor_task_runs_last_request_queue_request_lock_delete
  • Route: DELETE /v2/actor-tasks/{actorTaskId}/runs/last/request-queue/requests/{requestId}/lock
  • Mode: WRITE
  • Summary: Delete lock on request in last task run's default request queue
  • Parameters:
    • actorTaskId in path required
    • status in query
    • requestId in path required
    • clientKey in query
    • forefront in query