Skip to main content

Create a new task under an organization

POST 
/platform/solutions/api/v1/orgs/{orgId}/tasks

Create a new device task scoped to the specified organization.

Usage
POST /orgs/{orgId}/tasks

Parameters

  • orgId (string, required): the ID of the organization.
  • input (CreateUpdateDeviceTaskByOrgIdDto, required): the task definition, including:
    • Name (string, required): the name of the task.
    • Cmd (string, optional): the command to be executed.
    • Payload (string, optional): variables or payload for the task execution.

Responses

  • 201 Created: task created successfully, returns DeviceTaskDto.
  • 400 Bad Request: invalid input.
  • 404 Not Found: organization not found.
  • 409 Conflict: task name already exists under this org.

Security
This API requires authentication.

Request​

Responses​

Created