---
title: "Retrieve tasks."
method: GET
path: "/api/v1/accounts/{accountId}/tasks"
---

# Retrieve tasks.

`GET /api/v1/accounts/{accountId}/tasks`

## Request

- Base URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt`
- URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt/api/v1/accounts/{accountId}/tasks`
- Auth: API key in header `WatchGuard-API-Key` and HTTP bearer
- TypeScript: <https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/docs/api/v1/accounts/:accountId/tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all tasks created.

## Path parameters

- `accountId` string, required

## Query parameters

- `top` integer
- `skip` integer
- `count` boolean
- `filter` string

## Response `200`

OK

- TasksOutputFindResponse
  - `data` TasksOutput
    - `account_id` string, uuid: Identifier of the account.
    - `id` string, uuid: Identifier of the task.
    - `name` string: Name of the task.
    - `description` string: Description of the task.
    - `type` 1 | 2 | 6 | 7 | 10: Type of task. - 1: Antimalware scan task - 2: Malware disinfection task - 6: Patch installation task - 7: Patch uninstallation task - 10: IOC search task
    - `status` TaskStatus
      - `enabled` boolean: Indicates whether the task is enabled or not.
      - `delivery_state` 0 | 1 | 2 | 3 | 4: Delivery status of the task. - 0: Pending - 1: Ready for delivery - 2: Published - 3: Cancelled - 4: Finished
      - `last_job_date` string, date-time, nullable: Date of the last update of a repetition associated with the task.
    - `schedule` TaskSchedule
      - `type` 1 | 2 | 3: Type of schedule. - 1: Now - 2: One-time - 3: Recurring
      - `start_date` string, date-time: Start date of the schedule.
      - `is_local_time` boolean: Indicates whether the date is local.
      - `recurrence` TaskRecurrencePattern
        - `type` 1 | 2 | 3 | 4 | 5: Type of recurrence. - 1: Daily - 2: Weekly - 3: Monthly - 4: Yearly - 5: Hourly
        - `frequency` integer, nullable: Number of executions of the scheduled execution.
        - `days_of_week` integer[]
        - `week_of_month` 1 | 2 | 3 | 4 | 5, nullable: Week in the month the task is scheduled for (optional). - 1: First - 2: Second - 3: Third - 4: Fourth - 5: Last
        - `date_of_month` integer[]
        - `month_of_year` integer[]
      - `execution_timeout` string: How long the task can run from the time it starts.
      - `execution_window` 0 | 1, nullable: Execution window for the scheduled task. - 0: Only at specified time - 1: As soon as possible
      - `execution_window_expiration` string: Maximum wait time for the task to start if the target device is not available.
      - `publish_date` string, date-time, nullable: Publication date for the scheduled task.
    - `can_be_deleted` boolean: Indicates whether the task can be deleted.
    - `can_be_copied` boolean: Indicates whether the task can be copied.
    - `can_access_to_detailed_view` boolean: Indicates whether the task can access a detailed view.
    - `scope_type` 0 | 1 | 2: Indicates the scope of the task. - 0: Invalid - 1: Customer - 2: Partner
  - `total_items` integer, nullable: Total number of retrieved tasks.

## Other responses

- `400`: BAD REQUEST.
- `403`: ACCESS DENIED.
- `404`: NOT FOUND.
- `405`: METHOD NOT ALLOWED.
- `500`: INTERNAL ERROR.

---

[API](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api.md) - [All operations](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/revisions/1376eee70d39?raw)