Request setting a SIM card to standby

POST 
/sim_cards/:id/actions/set_standby

The SIM card will be able to connect to the network once the process to set it to standby has been completed, thus making it possible to consume data.
To set a SIM card to standby, it must be associated with SIM card group.
The API will trigger an asynchronous operation called a SIM Card Action. Transitioning to the standby state may take a period of time. The status of the SIM Card Action can be followed through the List SIM Card Action API.

Request

Path Parameters

id uuidrequired

Identifies the resource.

Responses

202: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object

This object represents a SIM card action. It allows tracking the current status of an operation that impacts the SIM card.

id uuid

Identifies the resource.

record_type string

sim_card_id uuid

The related SIM card identifier.

action_type string

Possible values: [enable, enable_standby_sim_card, disable, set_standby]

The operation type. It can be one of the following:


• enable - move the SIM card to the enabled status
• enable_standby_sim_card - move a SIM card previously on the standby status to the enabled status after it consumes data.
• disable - move the SIM card to the disabled status
• set_standby - move the SIM card to the standby status

status

object

value string

Possible values: [in-progress, completed, failed, interrupted]

The current status of the SIM card action.

reason string

It describes why the SIM card action is in the current status. This will be null for self-explanatory statuses, such as in-progress and completed but will include further information on statuses like interrupted and failed.

settings objectnullable

A JSON object representation of the action params.

created_at CreatedAt (string)

ISO 8601 formatted date-time indicating when the resource was created.

updated_at UpdatedAt (string)

ISO 8601 formatted date-time indicating when the resource was updated.

This object represents a SIM card action. It allows tracking the current status of an operation that impacts the SIM card.

{
  "data": {
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "record_type": "sim_card_action",
    "sim_card_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "action_type": "enable",
    "status": {
      "value": "completed",
      "reason": "The data limit was exceeded."
    },
    "settings": {},
    "created_at": "2018-02-02T22:25:27.521Z",
    "updated_at": "2018-02-02T22:25:27.521Z"
  }
}

default: Unexpected error

application/json

• Schema
• Example (from schema)

Schema

errors

Error[]

Array [

code intrequired

title stringrequired

detail string

source

object

pointer json-pointer

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

meta object

]

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}

Loading...