---
title: "A collection of asynchronous tasks"
method: GET
path: "/task"
tags: ["Task"]
---

# A collection of asynchronous tasks

`GET /task`

If you used the ?async=true query parameter to send a large declaration, you can use a GET request to the /task endpoint with the **recordId** returned by the POST to see the status of the processing (and the results if it is finished). Old task records are removed if the record is older than one week or more than 25 records exist.

## Response `200`

Successful response

- object
  - `id` string — A unique identifier for the task
  - `results` union[] — The results of the asynchronous task per-tenant
    - union
      - Result
        - `code` 0 | 200 | 202 | 422 | 500 — HTTP status code describing the outcome of applying the tenant's configuration. This will be 0 until the tenant is done being processed.
        - `message` string — The current status of the task to configure the tenant.
        - `lineCount` integer — The number of lines in the tenant's configuration.
        - `host` string — The host name that the tenant was deployed on.
        - `tenant` string — The tenant that was configured.
        - `runTime` integer — The time (in milliseconds) it took to process the tenant.
      - Declaration
      - Error
        - `code` integer — Code representing the error
        - `message` string — Additional information about the error
        - `errors` string[] — Details about schema validation failures
        - `declarationFullId` string — The id of the declaration
  - `declaration` union
    - Declaration
    - [object Object]

## Other responses

- `404` — No record exists for the given recordId
- `500` — Something went wrong internally, and a bug report should be filed: https://github.com/F5Networks/f5-appsvcs-extension/issues/new/choose

---

[API](https://skmtc.net/f5networks/apis/f5-big-ip-as3.md) · [All operations](https://skmtc.net/f5networks/apis/f5-big-ip-as3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/f5networks/f5-big-ip-as3/revisions/e7dc931778cf/schema)