---
title: "Apply BIG-IP DO configuration"
method: POST
path: "/"
tags: ["Configuration"]
---

# Apply BIG-IP DO configuration

`POST /`

Configure the device per the declaration.

## Request body

- Device — unresolved $ref

## Response `200`

Successful synchronous response.

- Task — The configuration status and associated declaration.
  - `id` string, uuid — Unique ID for task.
  - `selfLink` string, uri — URI at which to fetch task on the device.
  - `message` string — Overall result message.
  - `errors` string[] — Array of errors that occurred.
  - `result` Result — Standard result object in responses.
    - `class` 'Result'
    - `code` integer — Status code.
    - `status` 'OK' | 'ERROR' | 'ROLLING_BACK' | 'RUNNING' | 'REBOOTING' | 'REVOKING' — Status string.
    - `message` string — Overall result message.
    - `errors` string[] — Array of errors that occurred.
  - `declaration` Device — unresolved $ref
  - `currentConfig` ConfigObject
    - `Common` object — A collection of sub-objects that describe the configuration state of a device.
  - `originalConfig` ConfigObject
    - `Common` object — A collection of sub-objects that describe the configuration state of a device.

## Other responses

- `202` — Successful asynchronous response.
- `422` — Error while applying config.
- `500` — Something went wrong internally and a bug report should be filed: https://github.com/F5Networks/f5-declarative-onboarding/issues/new/choose.

## Changes

- **2022-09-22** `a6af033d6e51` — 1 info
  - endpoint added
- **2022-09-22** `89c43e8c94c8` — 1 breaking
  - api path removed without deprecation
- **2022-07-07** `416d108e05ed` — 8 info
  - api tag `Configuration` added
  - api tag `Declare` removed
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
  - …4 more
- **2020-05-21** `7fc26ad82f48` — 1 breaking, 3 warning, 4 info
  - removed the success response with the status `202`
  - removed the optional property `errors` from the response with the `200` status
  - removed the optional property `message` from the response with the `200` status
  - removed the optional property `result/errors` from the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/f5networks/apis/f5-big-ip-declarative-onboarding/changes/post.md)

---

[API](https://skmtc.dev/f5networks/apis/f5-big-ip-declarative-onboarding.md) · [All operations](https://skmtc.dev/f5networks/apis/f5-big-ip-declarative-onboarding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/f5networks/f5-big-ip-declarative-onboarding/revisions/ad4f7f41e106/schema)