Morphik Management API

Learn how to provision and manage isolated Morphik application environments.

The Morphik Management API provides endpoints for administering your Morphik instance, particularly for provisioning and managing isolated application environments. These features are typically available for Enterprise and Teams plan customers.

Application Provisioning

Morphik allows you to create dedicated, isolated environments for different projects or tenants. Each “app” consists of its own Postgres database and separate storage, ensuring data segregation and independent resource management.

Create a New Application

You can provision a new application environment using the following endpoint. This is an enterprise feature and requires appropriate authentication and plan eligibility.

This endpoint is available for users on the Teams or Enterprise plans. Teams plan users are subject to an application limit.

POST /ee/apps

This endpoint provisions a brand-new Postgres database and separate storage, configuring it as a Morphik application. The authenticated user making the request becomes the owner of the provisioned app.

Authentication

Requires a valid JWT Bearer token in the Authorization header. You can use a token obtained by authenticating against any Morphik API URI.

Request Body

Example Request (cURL):

curl -X POST \
  http://your-company.morphik.ai/ee/apps \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_name": "My New Marketing App",
    "region": "aws-us-west-2"
  }'

Response Body (201 Created)

Example Response:

{
  "app_id": "app_abc123xyz789",
  "app_name": "My New Marketing App",
  "morphik_uri": "morphik://{name}:{token}@your-company.morphik.ai",
  "status": "Provisioned"
}

That’s it! After receiving this response, you can interact with your newly provisioned and isolated application. To make API requests, just use the returned uri.