---
title: "Create Action Request On Specific CoAP Device."
method: POST
path: "/v1/integrate/devices/{deviceId}/actions/COAP"
tags: ["IoT Integrator"]
---

# Create Action Request On Specific CoAP Device.

`POST /v1/integrate/devices/{deviceId}/actions/COAP`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/devices/{deviceId}/actions/COAP`
- Auth: HTTP bearer

Initiate CoAP action on specific device.

## Path parameters

- `deviceId` string, required

## Request body

- Postschema2: Post CoAP device action.
  - `payload` string: Data that should be sent to a device
  - `payloadType` 'STRING' | 'BASE64': Type of the payload
  - `port` integer, required: Communication port number of a device
  - `path` string, required: Absolute path to the resource
  - `requestType` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', required: CoAP request type that should be sent
  - `requestMode` 'SEND_NOW' | 'SEND_WHEN_ACTIVE': Action request execution mode
  - `sendAttempts` number: The maximum number of attempts to send data to a device

## Response `202`

Message describing the result of operation

- PostResponseschema: Post device action response.
  - `id` string, required: Id of the created action request
  - `message` string, required: Message describing the result of operation.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)