{
  "schema_version": 2,
  "id": "operate/rc/api/examples/create-database",
  "title": "Create and manage databases",
  "url": "https://redis.io/docs/latest/operate/rc/api/examples/create-database/",
  "summary": "This article describes how to create and manage a database using the Redis Cloud API.",
  "tags": [
    "docs",
    "operate",
    "rc"
  ],
  "last_updated": "2026-09-25T14:59:52+01:00",
  "page_type": "content",
  "content_hash": "4193e06521a48ae189810357836089fd1972bfa8dd6ebfd1def5f01eee140e57",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "You can use the Redis Cloud REST API to create and manage databases."
    },
    {
      "id": "redis-cloud-essentials",
      "title": "Redis Cloud Essentials",
      "role": "content",
      "text": ""
    },
    {
      "id": "create-an-essentials-database",
      "title": "Create an Essentials database",
      "role": "content",
      "text": "To create a Redis Cloud Essentials database, use [`POST /fixed/subscriptions/{subscriptionId}/databases`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Essentials/operation/createFixedDatabase).\n\nThis call creates a database in the specified subscription. Use [`GET /fixed/subscriptions`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Subscriptions-Essentials/operation/getAllSubscriptions_1) to get a list of Essentials subscriptions and their IDs. \n\n[code example]\n\nThis example JSON body contains only the most basic, required parameters to create a database:\n\n- `name`: The database name. A unique name per subscription that can contain only alphanumeric characters and hyphens\n\nThere are other additional parameters and settings that can be defined on database creation. Review the database parameters and options in the [full API reference](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Essentials/operation/createFixedDatabase). \n\nSome options may not be compatible with your selected plan. Use [`GET /fixed/subscriptions/{subscriptionId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Subscriptions-Essentials/operation/getFixedSubscriptionsPlansBySubscriptionId) to view the plan you have selected and what options it supports.\n\nThe response body contains the `taskId` for the task that creates the database. You can use [`GET /v1/tasks/{taskId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById) to track the task's status."
    },
    {
      "id": "update-an-essentials-database",
      "title": "Update an Essentials database",
      "role": "content",
      "text": "To update a Redis Cloud Essentials database, use [`PUT /fixed/subscriptions/{subscriptionId}/databases/{databaseId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Essentials/operation/deleteFixedDatabaseByID). \n\nThe primary component of a database update request is the JSON request body that contains the details of the requested database changes. You can see the full set of changes you can make in the [full API reference](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Essentials/operation/deleteFixedDatabaseByID).\n\nSome options may not be compatible with your selected plan. Use [`GET /fixed/subscriptions/{subscriptionId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Subscriptions-Essentials/operation/getFixedSubscriptionsPlansBySubscriptionId) to view the plan you have selected and what options it supports.\n\nThe response body contains the `taskId` for the task that updates the database. You can use [`GET /v1/tasks/{taskId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById) to track the task's status."
    },
    {
      "id": "redis-cloud-pro",
      "title": "Redis Cloud Pro",
      "role": "content",
      "text": ""
    },
    {
      "id": "create-a-pro-database",
      "title": "Create a Pro database",
      "role": "content",
      "text": "If you want to create a Pro database in a new subscription, see [Create a Pro subscription](https://redis.io/docs/latest/operate/rc/api/examples/manage-subscriptions#create-a-pro-subscription).\n\nTo create a Redis Cloud Pro database in an existing subscription, use [`POST /subscriptions/{subscriptionId}/databases`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Pro/operation/createDatabase).\n\nThis call creates a database in the specified subscription. Use [`GET /subscriptions`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Subscriptions-Pro/operation/getAllSubscriptions) to get a list of subscriptions and their IDs. \n\n[code example]\n\nThis example JSON body contains only the most basic, required parameters to create a database:\n\n- `name`: The database name. A unique name per subscription that can contain only alphanumeric characters and hyphens\n- `datasetSizeInGb`: Maximum dataset size in GB\n\nThere are many additional parameters and settings that can be defined on database creation. Review the database parameters and options in the [full API reference](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Pro/operation/createDatabase).\n\nThe response body contains the `taskId` for the task that creates the database. You can use [`GET /v1/tasks/{taskId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById) to track the task's status."
    },
    {
      "id": "update-a-redis-cloud-pro-database",
      "title": "Update a Redis Cloud Pro database",
      "role": "content",
      "text": "To update a Redis Cloud Pro database, use [`PUT /subscriptions/{subscriptionId}/databases/{databaseId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Pro/operation/updateDatabase). \n\nThe primary component of a database update request is the JSON request body that contains the details of the requested database changes. You can see the full set of changes you can make in the [full API reference](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Databases-Pro/operation/updateDatabase).\n\nThe response body contains the `taskId` for the task that updates the database. You can use [`GET /v1/tasks/{taskId}`](https://redis.io/docs/latest/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById) to track the task's status."
    }
  ],
  "examples": [
    {
      "id": "create-an-essentials-database-ex0",
      "language": "shell",
      "code": "POST \"https://[host]/v1/fixed/subscriptions/{subscriptionId}/databases\"\n{\n  \"name\": \"Basic-essentials-database-example\"\n}",
      "section_id": "create-an-essentials-database"
    },
    {
      "id": "create-a-pro-database-ex0",
      "language": "shell",
      "code": "POST \"https://[host]/v1/subscriptions/{subscriptionId}/databases\"\n{\n  \"name\": \"Basic-database-example\",\n  \"datasetSizeInGb\": 1\n}",
      "section_id": "create-a-pro-database"
    }
  ]
}