Update Thing State

This guide will show you how you can change your Thing state via API.

Change a Thing state

PUT https://console.monogoto.io/thing/ThingId_ICCID_{ICCID}/state/

Path Parameters

Name	Type	Description
ICCID*	String	The ICCID of your SIM

Headers

Name	Type	Description
TOKEN_HERE*	String	Your authentication token

Request Body

Name	Type	Description
THING_STATE*	String	Possible variables: ACTIVE / SUSPENDED

200: OK State changed successfully

{
    // Response
}

401: Unauthorized Unauthorized

{
    // Response
}

404: Not Found Not found

{
    // Response
}

500: Internal Server Error Internal Server Error

{
    // Response
}

Example using cURL:

curl -X PUT \
    --url "https://console.monogoto.io/thing/ThingId_ICCID_{ICCID}/state/" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer {TOKEN_HERE}" \
    -d "{ \"state\": \"{THING_STATE}\"}"

Expected response:

{
    Thing state updated successfully.
}

Please note that the above shown command needs to be replaced with information:

• {ICCID} - replace with your Monogoto thing ICCID number

• {TOKEN_HERE} - replace with your token

• {THING_STATE} - replace with the state you wish your Thing to use:

  • ACTIVE - SIM card is activated and can be used

  • SUSPENDED - SIM card is suspended. Can not be used until status is changed to ACTIVE

Example of request setting Thing state to SUSPENDED:

curl -X PUT \
    --url "https://console.monogoto.io/thing/ThingId_ICCID_8912372646888991/state/" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" \
    -d "{ \"state\": \"SUSPENDED\"}"

Changes the state of a Thing

PUThttps://console.monogoto.io/thing/{ThingId}/state/

Path parameters

ThingId*string

Thing ID

Body

application/json

New state of Thing

stateenum

State of Thing

PROVISIONEDTEST_ACTIVESUSPENDEDACTIVERETIRED

Response

200401404500

State changed successfully

Request

JavaScriptCurlPython

const response = await fetch('https://console.monogoto.io/thing/{ThingId}/state/', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404500

{
  "message": "text"
}