HTTP API Reference for Momento Databases

Momento provides an HTTP API interface for managing Databases. This API lets you create, describe, list, and delete Databases programmatically.

Limited preview

Momento Cache is available in limited preview. Sign in or sign up in the Momento console and select Request access before calling this API.

A Database is a logical container pinned to exactly one Capacity Pool. Multiple Databases share the compute and memory of their Pool. A Database is identified by its name and the name of the Capacity Pool it belongs to.

Info

The Momento platform is region-based with endpoints specific to each region. To view a list of supported regions and their endpoints, click here.

Authentication

You will need a Momento API Key generated via the Momento console. Momento API Keys control access to the Momento services and can be set to expire.

The API Key must be provided in the Authorization header.

Use Database permissions to scope data-plane commands independently of control-plane API access.

---

Database API

The Database API lets you create, describe, list, and delete Databases. Each Database is pinned to exactly one Capacity Pool. There is no update operation; a Database has no mutable fields.

Create Database

Creates a new Database pinned to the specified Capacity Pool. The Pool must exist in the selected region and have active backing capacity.

Request

• Path: /database/{name}
• HTTP Method: POST

Path Parameters

Parameter name	Required?	Type	Description
name	yes	URL-safe string	The name of the Database.

Headers

Header name	Required?	Type	Description
Authorization	yes	String	The Momento API key, in string format, is used for authentication/authorization of the request.
Content-Type	yes	String	Must be application/json.

Request Body

{
  "pool_name": "prod-us-east-1"
}

Field	Required?	Type	Description
pool_name	yes	String	The name of the Capacity Pool this Database is pinned to.

Responses

Success

Status Code: 201 Created

{
  "name": "user-sessions",
  "pool_name": "prod-us-east-1"
}

Field	Type	Description
name	String	The name of the Database.
pool_name	String	The name of the Capacity Pool the Database is pinned to.

Error

Status Code: 400 Bad Request

• "Invalid Argument" indicates the request body contains invalid configuration, the specified Capacity Pool does not exist, or its backing capacity is not ready. Retry a provisioning Pool once it is active.

Status Code: 401 Unauthorized

• This error type typically indicates that the Momento API key passed in is either invalid or expired.

Status Code: 403 Forbidden

• This error type typically indicates the Momento API key passed in does not grant the required access.

Status Code: 409 Already Exists

• A Database with the specified name already exists.

Status Code: 429 Too Many Requests

• The account-wide or per-Pool Database limit has been reached. See Service limits.

Status Code: 500 Internal Server Error

• This error type typically indicates that the service is experiencing issues.

---

Describe Database

Retrieves the details of a specific Database.

Request

• Path: /database/{name}
• HTTP Method: GET

Path Parameters

Parameter name	Required?	Type	Description
name	yes	URL-safe string	The name of the Database.

Headers

Header name	Required?	Type	Description
Authorization	yes	String	The Momento API key, in string format, is used for authentication/authorization of the request.

Responses

Success

Status Code: 200 OK

{
  "name": "user-sessions",
  "pool_name": "prod-us-east-1"
}

Error

Status Code: 401 Unauthorized

• This error type typically indicates that the Momento API key passed in is either invalid or expired.

Status Code: 403 Forbidden

• This error type typically indicates the Momento API key passed in does not grant the required access.

Status Code: 404 Not Found

• The specified Database does not exist.

Status Code: 500 Internal Server Error

• This error type typically indicates that the service is experiencing issues.

---

List Databases

Lists all Databases owned by your account across all Capacity Pools in the region served by this API endpoint.

Request

• Path: /database
• HTTP Method: GET

Headers

Header name	Required?	Type	Description
Authorization	yes	String	The Momento API key, in string format, is used for authentication/authorization of the request.

Responses

Success

Status Code: 200 OK

{
  "databases": [
    {
      "name": "user-sessions",
      "pool_name": "prod-us-east-1"
    },
    {
      "name": "feature-flags",
      "pool_name": "prod-us-east-1"
    }
  ]
}

Field	Type	Description
databases	Array	The Databases owned by the calling account. Each entry has the same shape as the Describe Database response.

Error

Status Code: 401 Unauthorized

• This error type typically indicates that the Momento API key passed in is either invalid or expired.

Status Code: 403 Forbidden

• This error type typically indicates the Momento API key passed in does not grant the required access.

Status Code: 500 Internal Server Error

• This error type typically indicates that the service is experiencing issues.

---

Delete Database

Deletes a Database. The Database is removed synchronously; its underlying resources are reclaimed asynchronously.

Request

• Path: /database/{name}
• HTTP Method: DELETE

Path Parameters

Parameter name	Required?	Type	Description
name	yes	URL-safe string	The name of the Database.

Headers

Header name	Required?	Type	Description
Authorization	yes	String	The Momento API key, in string format, is used for authentication/authorization of the request.

Responses

Success

Status Code: 204 No Content

• The Database has been deleted. There is no response body.

Error

Status Code: 401 Unauthorized

• This error type typically indicates that the Momento API key passed in is either invalid or expired.

Status Code: 403 Forbidden

• This error type typically indicates the Momento API key passed in does not grant the required access.

Status Code: 404 Not Found

• The specified Database does not exist.

Status Code: 500 Internal Server Error

• This error type typically indicates that the service is experiencing issues.

---

Examples

Example: Create Database

Create a Database pinned to a Capacity Pool:

curl -X POST -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "pool_name": "prod-us-east-1"
  }' \
  "https://api.cache.cell-1-us-east-1-1.prod.a.momentohq.com/database/user-sessions"

Example: Describe Database

Get details for a specific Database:

curl -H "Authorization: <token>" \
  "https://api.cache.cell-1-us-east-1-1.prod.a.momentohq.com/database/user-sessions"

Example: List Databases

List all Databases in your account for the selected region:

curl -H "Authorization: <token>" \
  "https://api.cache.cell-1-us-east-1-1.prod.a.momentohq.com/database"

Example: Delete Database

Delete a Database:

curl -X DELETE -H "Authorization: <token>" \
  "https://api.cache.cell-1-us-east-1-1.prod.a.momentohq.com/database/user-sessions"