Bulk update SIM cards

POST 
/wireless/sim_cards/actions/bulk_update

Bulk updates to perform on a list of SIM cards

Request

application/json

Body

required

SIM card bulk update request

ids uuid[]

A list of IDs for which the changes will apply to.

enabled boolean

Whether the SIM card should be enabled or disabled.

sim_card_group_id uuid

The SIM card group to which all the provided SIM card IDs will be moved to.

tags string[]

A list of tags to apply to the provided SIM cards.

status string

Possible values: [enabled, disabled, standby]

The SIM card status to which all the provided SIM card IDs will be moved to.

authorized_imeis string[]

A list of authorized IMEIs that will be applied to all the provided SIM cards.

Responses

200: Successful response

application/json

• Schema
• Example (from schema)

Schema

failed_updates uuid[]

successful_updates

object

enabled boolean

Whether the SIM card is currently enabled or not

iccid string

The ICCID of the given card

id string

The id of the SIM card

sim_card_group

object

The SIM card group associated with the given card

id uuid

The id of the SIM card group

name string

The name of the SIM card group

The SIM card group associated with the given card

tags string[]

The searchable tags associated with the SIM card

updated_at string

Timestamp for when the SIM card was last updated

{
  "failed_updates": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "successful_updates": {
    "enabled": true,
    "iccid": "string",
    "id": "string",
    "sim_card_group": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    },
    "tags": [
      "string"
    ],
    "updated_at": "string"
  }
}

401: Authentication error

application/json

• Schema
• Example (from schema)

Schema

errors

object[]

Array [

code string

an application-specific error code, expressed as a stringified integer.

title string

a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

detail string

a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

pointer string

JSON pointer to the field which is causing the error.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

403: Authorization error

application/json

• Schema
• Example (from schema)

Schema

errors

object[]

Array [

code string

an application-specific error code, expressed as a stringified integer.

title string

a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.

detail string

a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.

pointer string

JSON pointer to the field which is causing the error.

]

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/wireless/sim_cards/actions/bulk_update' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "enabled": true,
  "sim_card_group_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tags": [
    "string"
  ],
  "status": "enabled",
  "authorized_imeis": [
    "string"
  ]
}'

Response samples

• 200
• 401
• 403

---

{
  "failed_updates": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "successful_updates": {
    "enabled": true,
    "iccid": "string",
    "id": "string",
    "sim_card_group": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    },
    "tags": [
      "string"
    ],
    "updated_at": "string"
  }
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "error title",
      "detail": "additional detail about the error",
      "pointer": "/pointer/to/field"
    }
  ]
}