# Create a converge action

API to create a converge action for a device.

Endpoint: POST /v2/converge
Version: 1.0.0
Security: apiKey

## Request fields (application/json):

  - `device_id` (string, required)
    ID of the device

  - `converge_with_provision_option` (boolean, required)

  - `schedule_type` (string)
    Following Schedule types are supported
 * IMMEDIATE: Schedule the command to execcute Immediately
* WINDOW: Schedule the command to execute within the given window
    Enum: "IMMEDIATE", "WINDOW"

  - `schedule_args` (object)

## Response 201 fields (application/json):

  - `content` (object)

  - `content.id` (string)
    Unique converge identifier

  - `content.device_id` (string)
    ID of the device

  - `content.converge_with_provision_option` (boolean)

  - `content.blueprint_info` (object)

  - `content.blueprint_info.blueprint_id` (string)
    Unique blueprint ID

  - `content.blueprint_info.blueprint_version_id` (string)
    Version ID of blueprint

  - `content.schedule_type` (string)
    Following Schedule types are supported
 * IMMEDIATE: Schedule the command to execcute Immediately
* WINDOW: Schedule the command to execute within the given window
    Enum: "IMMEDIATE", "WINDOW"

  - `content.schedule_args` (object)

  - `content.status` (string)
    Current aggregrated status of the converge action
    Enum: "QUEUED", "PROCESSING", "IN_PROGRESS", "SUCCESS", "FAILURE"

  - `content.reason` (string)
    details briefing the reason for current converge status

  - `content.created_by` (string)
    user id of the user

  - `content.created_at` (string)
    Creation timestamp of converge

  - `content.updated_at` (string)
    Updation timestamp of converge

## Response 400 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)

## Response 401 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)

## Response 500 fields (application/json):

  - `code` (integer, required)

  - `message` (string, required)

  - `content` (object)