---
title: "Create an Elastic IP"
method: POST
path: "/elastic_ips"
tags: ["Elastic Ips"]
---

# Create an Elastic IP

`POST /elastic_ips`

Creates a new Elastic IP and assigns it to the specified server. The IP is provisioned asynchronously—the response will show status `configuring` and the `id` will be `null` until provisioning completes. Currently only IPv4 /32 addresses in routed mode are supported.

## Request body

- CreateElasticIp
  - `data` object, required
    - `type` 'elastic_ips', required
    - `attributes` object
      - `mode` 'routed' | 'bgp' — How the elastic IP is delivered. Defaults to routed
      - `server_id` string — The server to assign the elastic IP to. Required in routed mode and rejected in bgp mode, which uses server_ids
      - `project_id` string, required — The project to create the elastic IP in
      - `server_ids` string[] — The servers that announce the elastic IP over BGP. Only used in bgp mode, where it may be omitted to allocate a VIP with no sessions
      - `site` string — The site slug to allocate the elastic IP in. Only used in bgp mode, where it is required when no server_ids are given

## Response `202`

Accepted

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/versions/7302d79e39bb/schema)