---
title: "Associate client devices with the provided core."
method: POST
path: "/cores/{thingName}/deviceTasks"
tags: ["Client Device Tasks"]
---

# Associate client devices with the provided core.

`POST /cores/{thingName}/deviceTasks`

Associates 1 or more client devices with an existing Greengrass V2 core.
If the referenced `thingName` does not exist, an AWS IoT Thing is provisioned using the provided `provisioningTemplate`.
The AWS IoT thing is then associated with the Greengrass V2 core.
This is an asynchronous call, meaning that when submitted the call will return immediately with a `taskId` while the cores are being created in the background. Use the `GET /deviceTasks/{taskId}` to retrieve the status of the task.

## Response `202`

Accepted

## Other responses

- `400` — Invalid input
- `409` — Conflict

## Changes

- **2023-07-15** `7fee7a72e42c` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Change history](https://skmtc.dev/aws-samples/apis/connected-device-framework-greengrass-v2-provisioning/changes/cores/:thingName/deviceTasks/post.md)

---

[API](https://skmtc.dev/aws-samples/apis/connected-device-framework-greengrass-v2-provisioning.md) · [All operations](https://skmtc.dev/aws-samples/apis/connected-device-framework-greengrass-v2-provisioning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/connected-device-framework-greengrass-v2-provisioning/revisions/7fee7a72e42c/schema)