---
title: "Request Private Wireless Gateway assignment for SIM card group"
method: POST
path: "/sim_card_groups/{id}/actions/set_private_wireless_gateway"
tags: ["SIM Card Groups"]
---

# Request Private Wireless Gateway assignment for SIM card group

`POST /sim_card_groups/{id}/actions/set_private_wireless_gateway`

This action will asynchronously assign a provisioned Private Wireless Gateway to the SIM card group. Completing this operation defines that all SIM cards in the SIM card group will get their traffic controlled by the associated Private Wireless Gateway. This operation will also imply that new SIM cards assigned to a group will inherit its network definitions. If it's moved to a different group that doesn't have a Private Wireless Gateway, it'll use Telnyx's default mobile network configuration.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `private_wireless_gateway_id` string, uuid, required — The identification of the related Private Wireless Gateway resource.

## Response `202`

Successful Response

- object
  - `data` SIMCardGroupAction — This object represents a SIM card group action request. It allows tracking the current status of an operation that impacts the SIM card group and SIM card in it.
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `id` string, uuid — Identifies the resource.
    - `record_type` string
    - `settings` object — A JSON object representation of the action params.
      - `private_wireless_gateway_id` string, uuid — The identification of the related Private Wireless Gateway resource.
    - `sim_card_group_id` string, uuid — The SIM card group identification.
    - `status` 'in-progress' | 'completed' | 'failed'
    - `type` 'set_private_wireless_gateway' | 'remove_private_wireless_gateway' | 'set_wireless_blocklist' | 'remove_wireless_blocklist' — Represents the type of the operation requested.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.

## Other responses

- `401` — Unauthorized
- `default` — Unexpected error

## Changes

- **2026-08-17** `1571b0380bd7` — 1 breaking
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `default`
- **2026-08-04** `8f5f4e537994` — 1 breaking
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `default`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/sim_card_groups/:id/actions/set_private_wireless_gateway/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)