deploy

2026-06-06 21:16:45 +00:00
parent fa7c71252f
commit dfb65e705f
17 changed files with 3113 additions and 4393 deletions
--- a/skills/actor-tasks/SKILL.md
+++ b/skills/actor-tasks/SKILL.md
@@ -0,0 +1,669 @@
+---
+name: actor-tasks-routes
+description: 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`