---
title: "Bind a fixed server IP to one of the account’s keys (starts pending)"
method: POST
path: "/v1/me/ip-bindings"
---

# Bind a fixed server IP to one of the account’s keys (starts pending)

`POST /v1/me/ip-bindings`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/me/ip-bindings`
- Auth: API key in cookie `gf_session`

The binding activates the first time that KEY calls the API from that IP — proof you control the address. From then on calls from the IP need no key and are authenticated, metered, scoped and billed as that key (`X-Grundfast-Auth: ip-binding` on the response). A presented key always wins; a wrong key is still a 401. Active bindings are immutable: delete and recreate to change one. Starter and up; the count is capped per plan.

## Request body

- IpBindingCreateInput
  - `apiKeyId` integer, required
  - `ip` string, required
  - `label` string

## Response `201`

Created (pending)

## Other responses

- `400`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error

---

[API](https://skmtc.dev/grundfast/apis/grundfast-api.md) · [All operations](https://skmtc.dev/grundfast/apis/grundfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grundfast/apis/grundfast-api/revisions/ccef6e299bb5?raw)
