---
title: "Assign new IP address to app"
method: POST
path: "/v1/apps/{app_name}/ip_assignments"
tags: ["Apps"]
---

# Assign new IP address to app

`POST /v1/apps/{app_name}/ip_assignments`

## Path parameters

- `app_name` string, required

## Request body

- AssignIPRequest
  - `network` string
  - `org_slug` string
  - `region` string
  - `service_name` string
  - `type` 'v4' | 'v6' | 'shared_v4' | 'private_v6' | 'egress_v4' | 'egress_v6' | 'egress_pair' — Type of IP address to allocate. "egress-pair" allocates both v4 and v6 egress IP addresses (recommended when using egress IPs).

## Response `200`

OK

- AssignIPResponse
  - `created_at` string
  - `egress` boolean
  - `ip` string
  - `ip_pair` IPPair
    - `v4` string
    - `v6` string
  - `region` string
  - `service_name` string
  - `shared` boolean

## Changes

- **2026-09-01** `fc09da744e5d` — 1 breaking, 9 info
  - request property `type` was restricted to a list of enum values
  - added the new `egress_pair` enum value to the request property `type`
  - added the new `egress_v4` enum value to the request property `type`
  - added the new `egress_v6` enum value to the request property `type`
  - …6 more
- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/apps/:app_name/ip_assignments/post.md)

---

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