---
title: "restore"
method: POST
path: "/v1/db/restore"
tags: ["v1", "db"]
---

# restore

`POST /v1/db/restore`

#### Controller: 

`github.com/ubccr/grendel/internal/api.(*Handler).Restore`

#### Middlewares:

- `github.com/go-fuego/fuego.defaultLogger.middleware`
- `github.com/ubccr/grendel/internal/api.(*Handler).authMiddleware`

---

Restore a backup of the DB

## Headers

- `Accept` string

## Request body

- DataDump — DataDump schema
  - `Hosts` object[]
    - `bonds` object[]
      - `bmc` boolean
      - `fqdn` string
      - `id` integer, nullable
      - `ifname` string
      - `ip` string
      - `mac` string
      - `mtu` integer
      - `peers` string[]
      - `vlan` string
    - `boot_image` string
    - `firmware` string
    - `id` integer, nullable
    - `interfaces` object[]
      - `bmc` boolean
      - `fqdn` string
      - `id` integer, nullable
      - `ifname` string
      - `ip` string
      - `mac` string
      - `mtu` integer
      - `vlan` string
    - `name` string
    - `provision` boolean
    - `tags` string[], nullable
    - `uid` string, nullable
  - `Images` object[]
    - `cmdline` string
    - `id` integer, nullable
    - `initrd` string[]
    - `kernel` string
    - `liveimg` string
    - `name` string
    - `provision_templates` object, nullable
    - `uid` string, nullable
    - `verify` boolean
  - `Roles` object[]
    - `name` string
    - `permission_list` object[]
      - `method` string
      - `path` string
    - `unassigned_permission_list` object[]
      - `method` string
      - `path` string
  - `Users` object[]
    - `created_at` string, date-time
    - `enabled` boolean
    - `hash` string
    - `id` integer
    - `modified_at` string, date-time
    - `role` string
    - `username` string

## Response `200`

OK

- GenericResponse — GenericResponse schema
  - `changed` integer
  - `detail` string
  - `title` string

## Other responses

- `default` — Default Error

---

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