# pcn management endpoints — NCM API

Beta. The write surface for Cradlepoint Private Cellular Networks, gathering cores, networks, radio groups and SIMs into one group. Full lifecycle across all four resources: list, create, update and delete. Use this to provision or change a PCN; pcn visibility endpoints covers the read-only metrics side.

Base URL: https://api.cradlepointecm.com

### GET /api/external/v3/beta/private_cellular_cores

private_cellular_cores_list

Return a list of private cellular cores.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[network_id] | query | string | no |  |
| filter[network_id][isnull] | query | boolean | no |  |
| filter[router_id] | query | string | no |  |
| page[after] | query | string | no |  |
| page[before] | query | string | no |  |
| page[size] | query | integer | no |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_cores" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/external/v3/beta/private_cellular_cores/{id}

private_cellular_cores_retrieve

Get a single private cellular core.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_cores/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/external/v3/beta/private_cellular_networks

private_cellular_networks_list

Return a list of private cellular networks

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| page[after] | query | string | no |  |
| page[before] | query | string | no |  |
| page[size] | query | integer | no |  |
| sort | query | array of string (name | -name) | no | Which field to use when ordering the results. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_networks" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### POST /api/external/v3/beta/private_cellular_networks

private_cellular_networks_create

Create a single private cellular network.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

**Request body**

**Example request**

```bash
curl -X POST "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_networks" \
  -H "Authorization: Bearer <token>"
```

**Response 201**

### GET /api/external/v3/beta/private_cellular_networks/{id}

private_cellular_networks_retrieve

Get a single private cellular network.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_networks/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### PUT /api/external/v3/beta/private_cellular_networks/{id}

private_cellular_networks_update

Update a single private cellular network

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Request body**

**Example request**

```bash
curl -X PUT "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_networks/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 202**

### DELETE /api/external/v3/beta/private_cellular_networks/{id}

private_cellular_networks_destroy

Delete a single private cellular network.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl -X DELETE "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_networks/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 204** — No response body

### GET /api/external/v3/beta/private_cellular_radio_groups

private_cellular_radio_groups_list

Return a list of private cellular radio groups.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[network_id] | query | string | no |  |
| page[after] | query | string | no |  |
| page[before] | query | string | no |  |
| page[size] | query | integer | no |  |
| sort | query | array of string (name | -name) | no | Which field to use when ordering the results. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_radio_groups" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### POST /api/external/v3/beta/private_cellular_radio_groups

private_cellular_radio_groups_create

Create a single private cellular radio group.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

**Request body**

**Example request**

```bash
curl -X POST "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_radio_groups" \
  -H "Authorization: Bearer <token>"
```

**Response 201**

### GET /api/external/v3/beta/private_cellular_radio_groups/{id}

private_cellular_radio_groups_retrieve

Get a single private cellular radio group.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_radio_groups/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### PUT /api/external/v3/beta/private_cellular_radio_groups/{id}

private_cellular_radio_groups_update

Update a single private cellular radio group.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Request body**

**Example request**

```bash
curl -X PUT "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_radio_groups/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 202**

### DELETE /api/external/v3/beta/private_cellular_radio_groups/{id}

private_cellular_radio_groups_destroy

Delete a single private cellular radio group.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl -X DELETE "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_radio_groups/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 204** — No response body

### GET /api/external/v3/beta/private_cellular_sims

private_cellular_sims_list

Return a list of private cellular sims.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[network_id] | query | string | no |  |
| filter[network_id][isnull] | query | boolean | no |  |
| page[after] | query | string | no |  |
| page[before] | query | string | no |  |
| page[size] | query | integer | no |  |
| sort | query | array of string (iccid | name | -name | -iccid | -imsi | imsi) | no | Which field to use when ordering the results. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_sims" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/external/v3/beta/private_cellular_sims/{id}

private_cellular_sims_retrieve

Get a single private cellular sim.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_sims/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### PUT /api/external/v3/beta/private_cellular_sims/{id}

private_cellular_sims_update

Update a single private cellular sim.

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | yes |  |

**Request body**

**Example request**

```bash
curl -X PUT "https://api.cradlepointecm.com/api/external/v3/beta/private_cellular_sims/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 202**