---
title: "POST /dbaas-grafana/{name}"
method: POST
path: "/dbaas-grafana/{name}"
tags: ["dbaas"]
---

# POST /dbaas-grafana/{name}

`POST /dbaas-grafana/{name}`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/dbaas-grafana/{name}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/dbaas-grafana/:name/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a DBaaS Grafana service

## Path parameters

- `name` string, required

## Request body

- object
  - `maintenance` object: Automatic maintenance settings
    - `dow` 'saturday' | 'tuesday' | 'never' | 'wednesday' | 'sunday' | 'friday' | 'monday' | 'thursday', required: Day of week for installing updates
    - `time` string, required: Time for installing updates, UTC
  - `plan` string, required: Subscription plan
  - `termination-protection` boolean: Service is protected against termination and powering off
  - `fork-from-service` string
  - `grafana-settings` JsonSchemaGrafana
    - `allow_embedding` boolean
    - `cookie_samesite` 'lax' | 'strict' | 'none'
    - `dashboard_previews_enabled` boolean: This feature is new in Grafana 9 and is quite resource intensive. It may cause low-end plans to work more slowly while the dashboard previews are rendering.
    - `metrics_enabled` boolean
    - `auth_azuread` object
      - `allow_sign_up` boolean
      - `allowed_domains` string[]
      - `allowed_groups` string[]
      - `auth_url` string, required
      - `client_id` string, required
      - `client_secret` string, required
      - `token_url` string, required
    - `alerting_enabled` boolean
    - `wal` boolean: Setting to enable/disable Write-Ahead Logging. The default value is false (disabled).
    - `unified_alerting_enabled` boolean
    - `auth_github` object
      - `allow_sign_up` boolean
      - `allowed_organizations` string[]
      - `auto_login` boolean
      - `client_id` string, required
      - `client_secret` string, required
      - `skip_org_role_sync` boolean
      - `team_ids` integer[]
    - `user_auto_assign_org` boolean
    - `dataproxy_send_user_header` boolean
    - `google_analytics_ua_id` string
    - `dashboards_versions_to_keep` integer
    - `editors_can_admin` boolean
    - `smtp_server` object
      - `from_address` string, required
      - `from_name` string, nullable
      - `host` string, required
      - `password` string, nullable
      - `port` integer, required
      - `skip_verify` boolean
      - `starttls_policy` 'OpportunisticStartTLS' | 'MandatoryStartTLS' | 'NoStartTLS'
      - `username` string, nullable
    - `auth_gitlab` object
      - `allow_sign_up` boolean
      - `allowed_groups` string[], required
      - `api_url` string
      - `auth_url` string
      - `client_id` string, required
      - `client_secret` string, required
      - `token_url` string
    - `alerting_nodata_or_nullvalues` 'alerting' | 'no_data' | 'keep_state' | 'ok'
    - `auth_basic_enabled` boolean
    - `date_formats` object
      - `default_timezone` string
      - `full_date` string
      - `interval_day` string
      - `interval_hour` string
      - `interval_minute` string
      - `interval_month` string
      - `interval_second` string
      - `interval_year` string
    - `service_log` boolean, nullable: Store logs for the service so that they are available in the HTTP API and console.
    - `disable_gravatar` boolean
    - `user_auto_assign_org_role` 'Viewer' | 'Admin' | 'Editor'
    - `dataproxy_timeout` integer
    - `viewers_can_edit` boolean
    - `dashboards_min_refresh_interval` string: Signed sequence of decimal numbers, followed by a unit suffix (ms, s, m, h, d), e.g. 30s, 1h
    - `auth_google` object
      - `allow_sign_up` boolean
      - `allowed_domains` string[], required
      - `client_id` string, required
      - `client_secret` string, required
    - `oauth_allow_insecure_email_lookup` boolean
    - `alerting_max_annotations_to_keep` integer
    - `auth_generic_oauth` object
      - `scopes` string[]
      - `allowed_domains` string[]
      - `allowed_organizations` string[]
      - `token_url` string, required
      - `name` string
      - `auth_url` string, required
      - `api_url` string, required
      - `auto_login` boolean
      - `client_id` string, required
      - `client_secret` string, required
      - `allow_sign_up` boolean
    - `custom_domain` string, nullable: Serve the web frontend using a custom CNAME pointing to the Aiven DNS name
    - `alerting_error_or_timeout` 'alerting' | 'keep_state'
  - `ip-filter` string[]: Allowed CIDR address blocks for incoming connections

## Response `200`

200

- Operation: Operation
  - `id` string, uuid: Operation ID
  - `reason` 'incorrect' | 'unknown' | 'unavailable' | 'forbidden' | 'busy' | 'fault' | 'partial' | 'not-found' | 'interrupted' | 'unsupported' | 'conflict': Operation failure reason
  - `reference` object: Related resource reference
    - `id` string, uuid: Reference ID
    - `link` string: Link to the referenced resource
    - `command` string: Command name
  - `message` string: Operation message
  - `state` 'failure' | 'pending' | 'success' | 'timeout': Operation status

## Changes

- **2024-09-18** `eae1143f1c63`: 2 info
  - added the new optional request property `grafana-settings/custom_domain`
  - added the new optional request property `grafana-settings/wal`
- **2024-05-22** `d1903c399d90`: 2 warning, 3 info
  - removed the request property `grafana-settings/privatelink_access`
  - removed the request property `grafana-settings/recovery_basebackup_name`
  - added the new optional request property `grafana-settings/auth_github/auto_login`
  - added the new optional request property `grafana-settings/auth_github/skip_org_role_sync`
  - …1 more
- **2023-12-08** `ec6a2a6bc1c1`: 30 info
  - added the new optional request property `grafana-settings/alerting_enabled`
  - added the new optional request property `grafana-settings/alerting_error_or_timeout`
  - added the new optional request property `grafana-settings/alerting_max_annotations_to_keep`
  - added the new optional request property `grafana-settings/alerting_nodata_or_nullvalues`
  - …26 more
- **2023-06-06** `cf7b08181585`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/dbaas-grafana/:name/post.md)

---

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