# Countdown API

Countdown API provides real-time eBay product data, including product details, customer reviews, seller feedback, and search results, enabling businesses and developers to access comprehensive eBay marketplace information.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 25
- **Triggers:** 0
- **Slug:** `COUNTDOWN_API`
- **Version:** 20260312_00

## Tools

### Clear Collection Requests

**Slug:** `COUNTDOWN_API_CLEAR_ALL_REQUESTS`

Clears (removes) all pending requests from a collection. Use this to reset a collection before adding new requests, or to cancel all queued requests. The collection must be in 'idle' status. Returns the updated collection details after clearing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | The unique 8-character alphanumeric ID of the collection to clear. Get this from list_collections or create_collection actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create a new collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_CREATE_COLLECTION`

Tool to create a new collection. Use when you need to batch and orchestrate multiple requests on a schedule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Collection name |
| `enabled` | boolean | No | Enable or disable scheduled runs |
| `priority` | string ("highest" | "high" | "normal" | "low" | "lowest") | No | Collection priority |
| `requests_type` | string ("mixed" | "search" | "product" | "reviews" | "seller_profile" | "seller_feedback" | "autocomplete" | "deals") | No | Lock collection to a specific request type; cannot be changed after creation. Use 'mixed' to allow any request type. |
| `schedule_type` | string ("monthly" | "weekly" | "daily" | "minutes" | "manual") | No | Run schedule type |
| `schedule_hours` | array | No | Hours (0-23) to run |
| `destination_ids` | array | No | Destination IDs to upload results to |
| `schedule_minutes` | string ("every_minute" | "every_2_minutes" | "every_5_minutes" | "every_10_minutes" | "every_15_minutes" | "every_20_minutes" | "every_25_minutes" | "every_30_minutes" | "every_hour") | No | Minute interval when schedule_type='minutes'. Determines how frequently the collection runs within each hour. |
| `notification_email` | string | No | Email to send notifications to |
| `notification_as_csv` | boolean | No | Output/upload results as CSV |
| `notification_as_json` | boolean | No | Output/upload results as JSON |
| `notification_webhook` | string | No | Webhook URL to POST when results are available |
| `schedule_days_of_week` | array | No | Days of week (0=Sun ... 6=Sat) for weekly schedules |
| `schedule_days_of_month` | array | No | Days of month (1-31) for monthly schedules |
| `notification_csv_fields` | string | No | Comma-separated field list when CSV enabled |
| `notification_as_jsonlines` | boolean | No | Output/upload results as JSON Lines |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_GET_COLLECTION`

Tool to retrieve details for a single collection by ID. Use when you need collection metadata and counts for a given collection ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique 8-character hexadecimal collection identifier (e.g., '51AE51AB') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collections

**Slug:** `COUNTDOWN_API_COLLECTIONS_LIST_COLLECTIONS`

Tool to list all collections for the authenticated account. Use when you need to retrieve paginated collections with filtering, sorting, and timing constraints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (default is 1). |
| `status` | string ("all" | "idle" | "queued" | "running") | No | Filter by status. Default is 'all'. |
| `sort_by` | string ("created_at" | "last_run" | "name" | "priority" | "status") | No | Field to sort by (default 'name'). |
| `page_size` | integer | No | Results per page (default 25, maximum 1000). |
| `search_term` | string | No | Limit results to collections whose name contains this term. |
| `search_type` | string ("contains" | "starts_with" | "ends_with" | "exact") | No | How to match the search_term. One of: contains, starts_with, ends_with, exact. |
| `created_after` | string | No | Only collections created after this ISO UTC timestamp (ISO 8601). |
| `created_before` | string | No | Only collections created before this ISO UTC timestamp (ISO 8601). |
| `destination_id` | string | No | Only collections with the specified destination id. |
| `last_run_after` | string | No | Only collections with last run after this ISO UTC timestamp (ISO 8601). |
| `sort_direction` | string ("ascending" | "descending") | No | Sort direction (default 'ascending'). |
| `last_run_before` | string | No | Only collections with last run before this ISO UTC timestamp (ISO 8601). |
| `only_with_results` | boolean | No | Only return collections that have result sets available. |
| `only_without_results` | boolean | No | Only return collections with no result sets available. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_START_COLLECTION`

Start processing a collection's queued requests on the Countdown API. Use this tool to manually trigger a collection to begin executing its requests. The collection must have at least one request added to it before it can be started. You need sufficient API credits to run all requests in the collection. Prerequisites: - Collection must exist (use List Collections or Create Collection first) - Collection must have at least one request added - Sufficient API credits available for the number of requests - Collection must not already be running

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | The unique identifier of the collection to start. Must be a valid collection ID obtained from creating or listing collections. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update an existing collection

**Slug:** `COUNTDOWN_API_COLLECTIONS_UPDATE_COLLECTION`

Update an existing collection's settings. Use this to modify collection properties like name, schedule, priority, notification settings, or enabled status. The collection_id must be obtained from list_collections or create_collection. Only specified fields are updated; omitted fields retain their current values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the collection |
| `enabled` | boolean | No | Enable or disable scheduled runs |
| `priority` | string ("highest" | "high" | "normal" | "low" | "lowest") | No | Collection priority |
| `collection_id` | string | Yes | ID of the collection to update (obtained from list_collections or create_collection) |
| `requests_type` | string ("mixed" | "search" | "product" | "reviews" | "seller profile" | "seller feedback" | "autocomplete" | "deals") | No | Lock collection to a specific request type; cannot be changed after creation |
| `schedule_type` | string ("monthly" | "weekly" | "daily" | "minutes" | "manual") | No | Run schedule type |
| `schedule_hours` | array | No | Hours (0-23) to run |
| `destination_ids` | array | No | Destination IDs to upload results to |
| `schedule_minutes` | string ("every minute" | "every 5 minutes" | "every 10 minutes" | "every 15 minutes" | "every 20 minutes" | "every 25 minutes" | "every 30 minutes" | "every hour") | No | Minute interval when schedule_type='minutes' |
| `notification_email` | string | No | Email to send notifications to |
| `notification_as_csv` | boolean | No | Output/upload results as CSV |
| `notification_as_json` | boolean | No | Output/upload results as JSON |
| `notification_webhook` | string | No | Webhook URL to POST when results are available |
| `schedule_days_of_week` | array | No | Days of week (0=Sun...6=Sat) for weekly schedules |
| `schedule_days_of_month` | array | No | Days of month (1-31) for monthly schedules |
| `notification_csv_fields` | string | No | Comma-separated field list when CSV enabled |
| `notification_as_jsonlines` | boolean | No | Output/upload results as JSON Lines |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### eBay Autocomplete

**Slug:** `COUNTDOWN_API_CORE_API_SEND_REQUEST`

Tool to fetch eBay autocomplete suggestions. Use when needing search-term-based suggestions from Countdown API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | The type of request. Must be "autocomplete" to retrieve autocomplete suggestions. |
| `ebay_domain` | string | No | eBay domain to retrieve autocomplete suggestions from. Supported domains include ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.com.au, ebay.ca, etc. |
| `search_term` | string | Yes | The search term to get autocomplete suggestions for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Collection Request

**Slug:** `COUNTDOWN_API_CREATE_COLLECTION_REQUEST`

Tool to create new requests within a collection for bulk eBay data retrieval. Use when you need to add search, product, reviews, or other eBay data queries to a collection that will be executed on schedule. Collections must be in 'idle' status to accept new requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `requests` | array | Yes | Array of request objects to add to the collection. Maximum 1,000 requests per call. Collections support up to 15,000 total requests |
| `collection_id` | string | Yes | The 8-character alphanumeric ID of the collection to add requests to. Collection must be in 'idle' status. Use 'List Collections' to find available collection IDs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Destination

**Slug:** `COUNTDOWN_API_CREATE_DESTINATION`

Creates a cloud storage destination where batch result sets will be automatically uploaded. Supports Amazon S3, S3-compatible services (MinIO, DigitalOcean Spaces), Google Cloud Storage, Microsoft Azure Blob Storage, and Alibaba Cloud OSS. When enabled=true, the API validates credentials by uploading and deleting a test file. Set enabled=false to create the destination without credential validation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | A descriptive name to identify this destination. |
| `type` | string ("s3" | "s3compatible" | "gcs" | "azure" | "oss") | Yes | Cloud storage provider type: 's3' for Amazon S3, 's3compatible' for S3-compatible services (MinIO, DigitalOcean Spaces), 'gcs' for Google Cloud Storage, 'azure' for Microsoft Azure Blob Storage, 'oss' for Alibaba Cloud OSS. |
| `enabled` | boolean | Yes | Whether automatic uploads to this destination are active. Set to false to create destination without validating credentials. |
| `s3_region` | string | No | AWS region or S3-compatible service region (e.g., 'us-east-1'). Optional for S3-compatible services. |
| `s3_endpoint` | string | No | S3-compatible service endpoint URL (e.g., 'https://minio.example.com:9000'). Required when type is 's3compatible'. |
| `oss_region_id` | string | No | Alibaba Cloud OSS region ID (e.g., 'oss-cn-hangzhou', 'oss-us-east-1'). Required when type is 'oss'. |
| `gcs_access_key` | string | No | Google Cloud Storage interoperable storage access key (HMAC key). Required when type is 'gcs'. |
| `gcs_secret_key` | string | No | Google Cloud Storage interoperable storage secret key (HMAC secret). Required when type is 'gcs'. |
| `oss_access_key` | string | No | Alibaba Cloud RAM user access key. Required when type is 'oss'. |
| `oss_secret_key` | string | No | Alibaba Cloud RAM user secret key. Required when type is 'oss'. |
| `s3_bucket_name` | string | No | Name of the S3 bucket to upload files to. Required when type is 's3' or 's3compatible'. |
| `s3_path_prefix` | string | No | Optional path prefix for uploaded files. Supports replacement tokens: %BATCH_ID%, %BATCH_NAME%, %RESULT_SET_ID%, %DATE%. |
| `gcs_bucket_name` | string | No | Name of the GCS bucket to upload files to. Required when type is 'gcs'. |
| `gcs_path_prefix` | string | No | Optional path prefix for uploaded files. Supports replacement tokens: %BATCH_ID%, %BATCH_NAME%, %RESULT_SET_ID%, %DATE%. |
| `oss_bucket_name` | string | No | Name of the Alibaba Cloud OSS bucket to upload files to. Required when type is 'oss'. |
| `oss_path_prefix` | string | No | Optional path prefix for uploaded files. Supports replacement tokens: %BATCH_ID%, %BATCH_NAME%, %RESULT_SET_ID%, %DATE%. |
| `s3_access_key_id` | string | No | AWS IAM access key ID. Required when type is 's3' or 's3compatible'. |
| `azure_account_key` | string | No | Azure Storage account access key. Required when type is 'azure'. |
| `azure_path_prefix` | string | No | Optional path prefix for uploaded files. Supports replacement tokens: %BATCH_ID%, %BATCH_NAME%, %RESULT_SET_ID%, %DATE%. |
| `azure_account_name` | string | No | Azure Storage account name. Required when type is 'azure'. |
| `azure_container_name` | string | No | Name of the Azure Blob container to upload files to. Required when type is 'azure'. |
| `s3_secret_access_key` | string | No | AWS IAM secret access key. Required when type is 's3' or 's3compatible'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Collection

**Slug:** `COUNTDOWN_API_DELETE_COLLECTION`

Tool to delete a collection and its configuration by ID. Use when you need to remove an existing, non-running collection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | ID of the collection to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Destination

**Slug:** `COUNTDOWN_API_DELETE_DESTINATION`

Tool to delete a destination by ID. Use when you need to remove an existing destination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination_id` | string | Yes | ID of the destination to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Single Request

**Slug:** `COUNTDOWN_API_DELETE_SINGLE_REQUEST`

Delete a specific request from a Countdown API collection by its ID. Use this to remove individual requests that are no longer needed. The collection must not be running when deleting requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | The unique identifier of the request to delete from the collection. Obtain this from the 'List Requests Paged' action. |
| `collection_id` | string | Yes | The unique identifier of the collection containing the request to delete. Obtain this from the 'List Collections' or 'Create Collection' action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Destinations

**Slug:** `COUNTDOWN_API_DESTINATIONS_LIST_DESTINATIONS`

Tool to list all destinations configured for the account. Use when you need to inspect or paginate through configured destinations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return; 10 destinations per page |
| `sort_by` | string ("type" | "name") | No | Sort field; valid values: 'type' or 'name'; use with sort_direction |
| `search_term` | string | No | Filter results to destinations whose names contain this term |
| `sort_direction` | string ("ascending" | "descending") | No | Sort direction; valid values: ascending or descending; use with sort_by |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Collection Requests

**Slug:** `COUNTDOWN_API_FIND_COLLECTION_REQUESTS`

Tool to find requests in a collection by custom_id or search query. Use when you need to search for specific requests within a collection using either an exact custom_id match or a text search query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search query to find requests. Searches across request fields and custom_id. Mutually exclusive with 'custom_id' parameter - provide either custom_id or q, not both. |
| `page` | integer | No | 1-indexed page number of matching results to retrieve. Each page returns up to 1000 requests. Start with page 1 and check requests_page_count in the response for total pages. |
| `custom_id` | string | No | Find requests with this exact custom_id. Mutually exclusive with 'q' parameter - provide either custom_id or q, not both. |
| `collection_id` | string | Yes | The 8-character alphanumeric ID of the collection to search. Use 'List Collections' to find available collection IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Information

**Slug:** `COUNTDOWN_API_GET_ACCOUNT`

Tool to retrieve account usage and current platform status. Use when needing to check plan, usage, and quota details for the authenticated user.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Error Logs

**Slug:** `COUNTDOWN_API_LIST_ERROR_LOGS`

Tool to list error logs from collection executions. Returns recent errors encountered during request processing with details about failed requests and their causes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Requests CSV

**Slug:** `COUNTDOWN_API_REQUESTS_EXPORT_CSV`

Export all requests from a collection as downloadable CSV files. Returns URLs to CSV files containing the request data. Use this tool when you need to bulk export or download collection request data in CSV format. The response includes paginated download links if the collection has many requests. Collections with no requests will return an empty pages array.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | The ID of the collection whose requests you want to export as CSV. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Requests as JSON

**Slug:** `COUNTDOWN_API_REQUESTS_EXPORT_JSON`

Tool to download all requests in a collection as JSON. Use when you need to export the entire request history for a collection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | ID of the collection to export requests from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Single Request

**Slug:** `COUNTDOWN_API_REQUESTS_UPDATE_SINGLE_REQUEST`

Tool to modify parameters of an existing request in a collection. Use when the collection is not running and you need to update eBay Product Data API parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Complete request parameters conforming to the eBay Product Data API schema. Must include required fields: 'type' (product/search/reviews/seller_profile/seller_feedback/category/autocomplete/deals), 'ebay_domain' (e.g., ebay.com, ebay.co.uk, ebay.de). Type-specific parameters: for 'product' use 'epid'; for 'search' use 'search_term'; etc. |
| `request_id` | string | Yes | ID of the specific request to update within the collection. |
| `collection_id` | string | Yes | ID of the collection containing the request to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Result Set

**Slug:** `COUNTDOWN_API_RESULTS_GET_RESULT_SET`

Tool to retrieve a collection run's result set payload. Use after a collection run completes to fetch metadata and download links.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique identifier of the collection containing the result set. Obtain from List Collections or Create Collection actions. |
| `result_set_id` | integer | Yes | Numeric ID of the result set to retrieve. Obtain from List Result Sets action or from collection's next_result_set_id minus 1 after a run completes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Result Sets

**Slug:** `COUNTDOWN_API_RESULTS_LIST_RESULT_SETS`

Tool to list result sets produced by a collection. Use when you need to retrieve all summary status of result sets generated by a collection within the 14-day retention window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique identifier of the collection to list result sets for. Obtain this from the List Collections action or from a previously created collection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resend Result Set Webhook

**Slug:** `COUNTDOWN_API_RESULTS_RESEND_RESULT_SET_WEBHOOK`

Resend the webhook notification for a collection's result set. Use this tool to retry webhook delivery when the original webhook POST failed or timed out. The collection must have a notification_webhook URL configured (either on the collection itself or on the account profile). Result sets are only available for 14 days after creation. Prerequisites: - Collection must exist with a valid notification_webhook URL configured - Result set must exist and not be expired (14-day retention) - Use List Result Sets to find valid result_set_id values

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | The unique 8-character alphanumeric identifier of the collection containing the result set. Obtain this from List Collections or Create Collection actions. |
| `result_set_id` | integer | Yes | The numeric ID of the result set within the collection (must be >= 1). Each time a collection runs, it generates a new result set with an incrementing ID. Obtain valid IDs from List Result Sets action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stop All Collections

**Slug:** `COUNTDOWN_API_STOP_ALL_COLLECTIONS`

Tool to stop all collections. Use when you need to halt any running or queued collections after reviewing operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stop Collection

**Slug:** `COUNTDOWN_API_STOP_COLLECTION`

Tool to stop (pause) a single collection’s processing by ID. Use when you need to halt a running or queued collection after confirming the target collection ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | The unique identifier of the collection to stop. The collection must be in 'running' or 'queued' status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Destination

**Slug:** `COUNTDOWN_API_UPDATE_DESTINATION`

Tool to update a destination's configuration by ID. Use after creating or retrieving a destination to modify its settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Destination name |
| `type` | string ("s3" | "s3compatible" | "gcs" | "azure" | "oss") | No | Destination type |
| `enabled` | boolean | No | Whether uploads are active for this destination |
| `s3_region` | string | No | S3 region (optional when type is s3compatible) |
| `s3_endpoint` | string | No | S3 endpoint URL (required when type is s3compatible) |
| `oss_region_id` | string | No | OSS region ID (required when type is oss) |
| `destination_id` | string | Yes | Unique identifier of the destination to update. Obtain from list_destinations or create_destination. |
| `gcs_access_key` | string | No | GCS access key (required when type is gcs) |
| `gcs_secret_key` | string | No | GCS secret key (required when type is gcs) |
| `oss_access_key` | string | No | OSS access key (required when type is oss) |
| `oss_secret_key` | string | No | OSS secret key (required when type is oss) |
| `s3_bucket_name` | string | No | S3 bucket name (required when type is s3 or s3compatible) |
| `s3_path_prefix` | string | No | S3 path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date% |
| `gcs_bucket_name` | string | No | GCS bucket name (required when type is gcs) |
| `gcs_path_prefix` | string | No | GCS path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date% |
| `oss_bucket_name` | string | No | OSS bucket name (required when type is oss) |
| `oss_path_prefix` | string | No | OSS path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date% |
| `s3_access_key_id` | string | No | S3 access key id (required when type is s3 or s3compatible) |
| `azure_account_key` | string | No | Azure account key (required when type is azure) |
| `azure_path_prefix` | string | No | Azure path prefix (optional); supports tokens %collection_id%, %collection_name%, %result_set_id%, %date% |
| `azure_account_name` | string | No | Azure account name (required when type is azure) |
| `azure_container_name` | string | No | Azure container name (required when type is azure) |
| `s3_secret_access_key` | string | No | S3 secret access key (required when type is s3 or s3compatible) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |