---
title: "POST /alias"
method: POST
path: "/alias"
tags: ["alias"]
---

# POST /alias

`POST /alias`

Adds alias to system

## Request body

- AliasStruct
  - `alias` string, required — alias name
  - `captureID` string, required
  - `guid` string
  - `id` integer
  - `ip` string, required
  - `mask` integer, required
  - `port` integer, required
  - `status` boolean

## Response `201`

AliasCreationSuccessResponse

- AliasCreationSuccessResponse
  - `data` string
  - `message` string

## Other responses

- `401` — FailureResponse

## Changes

- **2021-10-13** `ee397eaefd08` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-09** `a5730259529b` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-08** `d39f8246865f` — 7 info
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `in` was added to the API
  - the endpoint scheme security `name` was added to the API
  - the endpoint scheme security `type` was added to the API
  - …3 more
- **2020-04-01** `8739183b4c43` — 1 info
  - api operation id `AddAlias` removed and replaced with `aliasAddAlias`
- **2020-01-12** `52987c8da72a` — 1 breaking, 7 info
  - removed the success response with the status `201`
  - api operation id `aliasAddAlias` removed and replaced with `AddAlias`
  - the endpoint scheme security `SecurityDefinitions` was removed from the API
  - the endpoint scheme security `in` was removed from the API
  - …4 more

[Change history](https://skmtc.dev/sipcapture/apis/homer-app/changes/alias/post.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/ee397eaefd08/schema)