---
title: "POST /api/v1.0/{appId}/hydra/registration"
method: POST
path: "/api/v1.0/{appId}/hydra/registration"
tags: ["Hydra"]
---

# POST /api/v1.0/{appId}/hydra/registration

`POST /api/v1.0/{appId}/hydra/registration`

## Request

- Base URL: `https://api.flipdish.co`
- URL: `https://api.flipdish.co/api/v1.0/{appId}/hydra/registration`
- Auth: OAuth 2 (implicit, authorization URL `https://api.flipdish.co/identity/connect/authorize`, scopes: `api`)

## Path parameters

- `appId` string, required

## Request body

- HydraRegistrationRequest: Hydra registration result
  - `StoreIds` integer[], required: Stores to assign the hydra
  - `DeviceName` string, required: Hydra device name
  - `PinCode` integer: 6 digit PIN code (not starting with zero).

## Response `200`

OK

- RestApiResultHydraStatus: Rest api result
  - `Data` HydraStatus, required: Hydra status
    - `AppId` string, required
    - `StoreIds` integer[]: Store to assign the hydra
    - `PropertyIds` string[]: AuthZ Property ids for assigned stores
    - `IsRegistered` boolean, required: The device has been already registered
    - `PinCode` integer, nullable: 6 digit PIN code (not starting with zero).
    - `Images` string[]: Hydra images (covers)
    - `UserType` 'Kiosk' | 'Terminal' | 'LegacyPrinter': Hydra User Type as integer. Prefer {Flipdish.PublicModels.V1.Hydra.HydraStatus.DeviceType}.
    - `DeviceType` 'Kiosk' | 'Terminal' | 'LegacyPrinter': Hydra device type (Kiosk / Terminal), serialized as string.
    - `HydraUserId` integer: Zeus Hydra user id

## Other responses

- `400`: BadRequest
- `401`: Authentication has been denied for this request.
- `403`: Successful authentication, but authorization has been denied for this request.
- `404`: NotFound

---

[API](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0.md) · [All operations](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0/llms.txt) · [OpenAPI document](https://skmtc.dev/flipdish/apis/flipdish-open-api-v1-0/revisions/ec0c138b13ca?raw)