HTTP API ReferenceLast updated July 9, 2026

Applications API Reference

Reference documentation for the applications & user-applications HTTP endpoints.

The Applications API allows you to manage and deploy applications, such as Studios and SDK apps.

Authentication

All requests must be authenticated.

Base API server URL

Production environment

https://api.sanity.io

Production environment with projectId subdomain

https://{projectId}.api.sanity.io

Variables

projectIdstringdefault: ""
Sanity project ID

Applications

Endpoints for managing applications

List applications for an organization

get/{apiVersion}/applications/

List all applications for an organization — both org-owned apps and installed singletons — in a unified response. Supports cursor-based pagination and optional includes for deployment children and installation config.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

organizationIdstringrequired
Organization to list applications for
type
Filter by application type
includestring
Comma-separated list of related data to include. Allowed values: interfaces, workspaces, access, installationConfig
limitdefault: 50
Maximum number of results per page (1-100, default 50). Pass "none" to disable pagination.
cursorstring
Cursor from a previous response to fetch the next page

Responses

Select response

200

Default Response

nextCursorrequired
Show child attributes
Select any
string
dataarrayrequired
Show child attributes
items
- idstringrequired
- typerequired
  Show child attributes
  Select any
  string
  enum:"studio"
- titlestringrequired
- isSingletonbooleanrequired
- slugrequired
  Show child attributes
  Select any
  string
- externalUrlrequired
  Show child attributes
  Select any
  string
- organizationIdstringrequired
- createdAtstring (date-time)required
- updatedAtstring (date-time)required
- configrequired
  Show child attributes
  Select any
  studioobjectrequired
  Show child attributes
  projectIdstringrequired
  Primary project association for the studio
  autoUpdatingVersionrequired
  Release channel (next, stable, latest) or a pinned semver; null if unset
  Show child attributes
  Select any
  string
  dashboardStatusrequired
  Controls dashboard UI visibility
  Show child attributes
  Select any
  string
  enum:"default"
- installationIdrequired
  Show child attributes
  Select any
  string
- activeInstallationConfig
  Show child attributes
  Select any
  idstringrequired
  deployedByrequired
  Show child attributes
  Select any
  string
  createdAtstring (date-time)required
- activeDeploymentobjectrequired
  Show child attributes
  idstringrequired
  applicationIdstringrequired
  sizerequired
  Show child attributes
  Select any
  integer
  versionrequired
  Show child attributes
  Select any
  string
  isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
  isActiveDeploymentbooleanrequired
  deployedByrequired
  Show child attributes
  Select any
  string
  createdAtstring (date-time)required
  updatedAtstring (date-time)required
  interfacesarray
  Show child attributes
  items
  idstringrequired
  typerequired
  Show child attributes
  Select any
  string
  enum:"app"
  namestringrequired
  titlestringrequired
  versionstringrequired
  entryPointstringrequired
  Resolved GCS URL for the federated module (relative tarball path on input)
  metadatarequired
  Show child attributes
  Select any
  groupstring
  prioritynumber
  workspaces
  Show child attributes
  Select any
  items
  idstringrequired
  namestringrequired
  titlerequired
  Show child attributes
  Select any
  string
  subtitlerequired
  Show child attributes
  Select any
  string
  projectIdstringrequired
  datasetstringrequired
  schemaDescriptorIdrequired
  Show child attributes
  Select any
  string
  basePathrequired
  Show child attributes
  Select any
  string
  iconrequired
  Show child attributes
  Select any
  string
  access
  Show child attributes
  Select any
  items
  idstringrequired
  resourceTyperequired
  Show child attributes
  Select any
  string
  enum:"datasets"
  resourceIdstringrequired

Create an application

post/{apiVersion}/applications/

Create an application and its initial deployment in the registry. Requires the sanity.sdk.applications.deploy grant.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `multipart/form-data`

typestringrequired
Behavioral category. Singletons use coreApp.
titlestringrequired
Human-friendly display name
isSingletonboolean
When true: slug required and organizationId must be Sanity’s org.
organizationIdstringrequired
Owning organization ID
slugstring
Subdomain for Sanity-hosted apps. Mutually exclusive with externalUrl.
externalUrlstring (uri)
URL for externally hosted studios (https only).
versionstringrequired
Deployment version identifier (e.g. "3.40.0")
isAutoUpdatingboolean
Flags whether this deployment is an auto-update build. Always false for external studios.
tarballstring (binary)
Gzipped tarball. Required for Sanity-hosted apps; not allowed for external studios.
configobject
JSON part. Application config; studio settings under studio (studios only).
Show child attributes
- studioobject
  Show child attributes
  projectIdstringrequired
  Studio-only. Required for studios.
  autoUpdatingVersion
  Release channel or pinned semver. Defaults to latest.
  Show child attributes
  Select one
  string
  enum:"next", "stable", "latest"
  dashboardStatusstring
  Controls dashboard UI visibility. Defaults to default.
interfacesarray
JSON part. Required for Sanity-hosted apps; not allowed for external studios.
Show child attributes
items
- typestringrequired
- namestringrequired
  Unique within type per deployment (e.g. "edit-document")
- titlestringrequired
  Human-friendly display name
- versionstringrequired
  Version of the interface (e.g. "1.0.0")
- entryPointstringrequired
  Relative path within the tarball (e.g. "index.js"); resolved to a GCS URL.
- metadataobject
  Show child attributes
  groupstring
  Grouping key for the interface
  prioritynumber
  Ordering priority within the group
accessarray
JSON part. Resource declarations. Not allowed for singletons.
Show child attributes
items
- resourceTypestringrequired
  Resource category
- resourceIdstringrequired
  The ID of the specific resource

Responses

Select response

201

Default Response

Select any

idstringrequired
typestringrequired
titlestringrequired
isSingletonbooleanrequired
slugrequired
Show child attributes
Select any
string
externalUrlrequired
Show child attributes
Select any
string
organizationIdstringrequired
createdAtstring (date-time)required
updatedAtstring (date-time)required
activeDeploymentobjectrequired
A deployment with its interfaces, workspaces, and access declarations
Show child attributes
- idstringrequired
- applicationIdstringrequired
- sizerequired
  Show child attributes
  Select any
  integer
- versionrequired
  Show child attributes
  Select any
  string
- isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
- isActiveDeploymentbooleanrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- createdAtstring (date-time)required
- updatedAtstring (date-time)required
- interfacesarrayrequired
  Show child attributes
  items
  idstringrequired
  typerequired
  Show child attributes
  Select any
  string
  enum:"app"
  namestringrequired
  titlestringrequired
  versionstringrequired
  entryPointstringrequired
  Resolved GCS URL for the federated module (relative tarball path on input)
  metadatarequired
  Show child attributes
  Select any
  groupstring
  prioritynumber
- workspacesrequired
  Show child attributes
  Select any
  items
  idstringrequired
  namestringrequired
  titlerequired
  Show child attributes
  Select any
  string
  subtitlerequired
  Show child attributes
  Select any
  string
  projectIdstringrequired
  datasetstringrequired
  schemaDescriptorIdrequired
  Show child attributes
  Select any
  string
  basePathrequired
  Show child attributes
  Select any
  string
  iconrequired
  Show child attributes
  Select any
  string
- accessrequired
  Show child attributes
  Select any
  items
  idstringrequired
  resourceTyperequired
  Show child attributes
  Select any
  string
  enum:"datasets"
  resourceIdstringrequired
configobjectrequired
Show child attributes
- studioobjectrequired
  Show child attributes
  projectIdstringrequired
  Primary project association for the studio
  autoUpdatingVersionrequired
  Release channel (next, stable, latest) or a pinned semver; null if unset
  Show child attributes
  Select any
  string
  dashboardStatusrequired
  Controls dashboard UI visibility
  Show child attributes
  Select any
  string
  enum:"default"

Get an application by ID

get/{apiVersion}/applications/{applicationId}

Retrieve a single application by ID, including its active deployment summary. Supports optional includes for deployment children (interfaces, workspaces, access).

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

includestring
Comma-separated list of active deployment children to include. Allowed values: interfaces, workspaces, access

Responses

Select response

200

Default Response

idstringrequired
typerequired
Show child attributes
Select any
string
enum:"studio"
titlestringrequired
isSingletonbooleanrequired
slugrequired
Show child attributes
Select any
string
externalUrlrequired
Show child attributes
Select any
string
organizationIdstringrequired
createdAtstring (date-time)required
updatedAtstring (date-time)required
configrequired
Show child attributes
Select any
studioobjectrequired
Show child attributes
projectIdstringrequired
Primary project association for the studio
autoUpdatingVersionrequired
Release channel (next, stable, latest) or a pinned semver; null if unset
Show child attributes
Select any
string
dashboardStatusrequired
Controls dashboard UI visibility
Show child attributes
Select any
string
enum:"default"
activeDeploymentobjectrequired
Show child attributes
- idstringrequired
- applicationIdstringrequired
- sizerequired
  Show child attributes
  Select any
  integer
- versionrequired
  Show child attributes
  Select any
  string
- isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
- isActiveDeploymentbooleanrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- createdAtstring (date-time)required
- updatedAtstring (date-time)required
- interfacesarray
  Show child attributes
  items
  idstringrequired
  typerequired
  Show child attributes
  Select any
  string
  enum:"app"
  namestringrequired
  titlestringrequired
  versionstringrequired
  entryPointstringrequired
  Resolved GCS URL for the federated module (relative tarball path on input)
  metadatarequired
  Show child attributes
  Select any
  groupstring
  prioritynumber
- workspaces
  Show child attributes
  Select any
  items
  idstringrequired
  namestringrequired
  titlerequired
  Show child attributes
  Select any
  string
  subtitlerequired
  Show child attributes
  Select any
  string
  projectIdstringrequired
  datasetstringrequired
  schemaDescriptorIdrequired
  Show child attributes
  Select any
  string
  basePathrequired
  Show child attributes
  Select any
  string
  iconrequired
  Show child attributes
  Select any
  string
- access
  Show child attributes
  Select any
  items
  idstringrequired
  resourceTyperequired
  Show child attributes
  Select any
  string
  enum:"datasets"
  resourceIdstringrequired

Update an application

patch/{apiVersion}/applications/{applicationId}

Update an application's mutable properties. Requires the sanity.sdk.applications.deploy grant.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `application/json`

titlestring
Human-friendly display name

Responses

Select response

200

An application in the unified registry, without deployment information

idstringrequired
typerequired
Show child attributes
Select any
string
enum:"studio"
titlestringrequired
isSingletonbooleanrequired
slugrequired
Show child attributes
Select any
string
externalUrlrequired
Show child attributes
Select any
string
organizationIdstringrequired
createdAtstring (date-time)required
updatedAtstring (date-time)required

Delete an application

delete/{apiVersion}/applications/{applicationId}

Soft-delete an application and all its deployments. Requires the sanity.sdk.applications.delete grant. Singletons with active installations cannot be deleted.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Confirms the application and its deployments were soft-deleted

deletedbooleanrequired

Get interfaces by type for an application

get/{apiVersion}/applications/{applicationId}/interfaces

Retrieve interfaces of a specific type for an application, resolved from the active deployment.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

interfaceTyperequired

Responses

Select response

200

Default Response

items

idstringrequired
typerequired
Show child attributes
Select any
string
enum:"app"
namestringrequired
titlestringrequired
versionstringrequired
entryPointstringrequired
Resolved GCS URL for the federated module (relative tarball path on input)
metadatarequired
Show child attributes
Select any
groupstring
prioritynumber

Get workspaces for an application

get/{apiVersion}/applications/{applicationId}/workspaces

Retrieve workspaces for a studio application, resolved from the active deployment. Returns null for non-studio applications.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

Select any

items

idstringrequired
namestringrequired
titlerequired
Show child attributes
Select any
string
subtitlerequired
Show child attributes
Select any
string
projectIdstringrequired
datasetstringrequired
schemaDescriptorIdrequired
Show child attributes
Select any
string
basePathrequired
Show child attributes
Select any
string
iconrequired
Show child attributes
Select any
string

Get resources for an application

get/{apiVersion}/applications/{applicationId}/resources

Retrieve the Sanity resources an application accesses, resolved from the active deployment. Returns null for singletons.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

Select any

items

idstringrequired
resourceTyperequired
Show child attributes
Select any
string
enum:"datasets"
resourceIdstringrequired

List deployments for an application

get/{apiVersion}/applications/{applicationId}/deployments

Retrieve the deployment history for an application. Returns all non-deleted deployments with nested children (interfaces, workspaces, access), ordered by creation date descending.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

limitdefault: 50
Maximum number of results per page (1-100, default 50). Pass "none" to disable pagination.
cursorstring
Cursor from a previous response to fetch the next page

Responses

Select response

200

Default Response

nextCursorrequired
Show child attributes
Select any
string
dataarrayrequired
Show child attributes
items
- idstringrequired
- applicationIdstringrequired
- sizerequired
  Show child attributes
  Select any
  integer
- versionrequired
  Show child attributes
  Select any
  string
- isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
- isActiveDeploymentbooleanrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- createdAtstring (date-time)required
- updatedAtstring (date-time)required
- interfacesarrayrequired
  Show child attributes
  items
  idstringrequired
  typerequired
  Show child attributes
  Select any
  string
  enum:"app"
  namestringrequired
  titlestringrequired
  versionstringrequired
  entryPointstringrequired
  Resolved GCS URL for the federated module (relative tarball path on input)
  metadatarequired
  Show child attributes
  Select any
  groupstring
  prioritynumber
- workspacesrequired
  Show child attributes
  Select any
  items
  idstringrequired
  namestringrequired
  titlerequired
  Show child attributes
  Select any
  string
  subtitlerequired
  Show child attributes
  Select any
  string
  projectIdstringrequired
  datasetstringrequired
  schemaDescriptorIdrequired
  Show child attributes
  Select any
  string
  basePathrequired
  Show child attributes
  Select any
  string
  iconrequired
  Show child attributes
  Select any
  string
- accessrequired
  Show child attributes
  Select any
  items
  idstringrequired
  resourceTyperequired
  Show child attributes
  Select any
  string
  enum:"datasets"
  resourceIdstringrequired

Deploy an application

post/{apiVersion}/applications/{applicationId}/deployments

Deploy a new version to an existing application. The new deployment becomes active, superseding the previous one. Requires the sanity.sdk.applications.deploy grant.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `multipart/form-data`

versionstringrequired
Deployment version identifier (e.g. "3.41.0")
tarballstring (binary)
Gzipped tarball. Required for Sanity-hosted apps; not allowed for external studios.
isAutoUpdatingboolean
Flags whether this deployment is an auto-update build. Always false for external studios.
interfacesarray
JSON part. Required for Sanity-hosted apps; not allowed for external studios.
Show child attributes
items
- typestringrequired
- namestringrequired
  Unique within type per deployment (e.g. "edit-document")
- titlestringrequired
  Human-friendly display name
- versionstringrequired
  Version of the interface (e.g. "1.0.0")
- entryPointstringrequired
  Relative path within the tarball (e.g. "index.js"); resolved to a GCS URL.
- metadataobject
  Show child attributes
  groupstring
  Grouping key for the interface
  prioritynumber
  Ordering priority within the group
accessarray
JSON part. Resource declarations. Not allowed for singletons.
Show child attributes
items
- resourceTypestringrequired
  Resource category
- resourceIdstringrequired
  The ID of the specific resource

Responses

Select response

201

A deployment with its interfaces, workspaces, and access declarations

idstringrequired
applicationIdstringrequired
sizerequired
Show child attributes
Select any
integer
versionrequired
Show child attributes
Select any
string
isAutoUpdatingrequired
Show child attributes
Select any
boolean
isActiveDeploymentbooleanrequired
deployedByrequired
Show child attributes
Select any
string
createdAtstring (date-time)required
updatedAtstring (date-time)required
interfacesarrayrequired
Show child attributes
items
- idstringrequired
- typerequired
  Show child attributes
  Select any
  string
  enum:"app"
- namestringrequired
- titlestringrequired
- versionstringrequired
- entryPointstringrequired
  Resolved GCS URL for the federated module (relative tarball path on input)
- metadatarequired
  Show child attributes
  Select any
  groupstring
  prioritynumber
workspacesrequired
Show child attributes
Select any
items
idstringrequired
namestringrequired
titlerequired
Show child attributes
Select any
string
subtitlerequired
Show child attributes
Select any
string
projectIdstringrequired
datasetstringrequired
schemaDescriptorIdrequired
Show child attributes
Select any
string
basePathrequired
Show child attributes
Select any
string
iconrequired
Show child attributes
Select any
string
accessrequired
Show child attributes
Select any
items
idstringrequired
resourceTyperequired
Show child attributes
Select any
string
enum:"datasets"
resourceIdstringrequired

Installations

Endpoints for installing and uninstalling singleton applications

Install a singleton application

post/{apiVersion}/applications/{applicationId}/installations

Install a singleton application for an organization. Requires a service token. Creates an installation record linking the organization to the singleton.

Path parameters

applicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `application/json`

organizationIdstringrequired
The organization gaining access to the singleton

Responses

Select response

201

An installation linking an organization to a singleton application

idstringrequired
applicationIdstringrequired
organizationIdstringrequired
installedByrequired
Show child attributes
Select any
string
createdAtstring (date-time)required
updatedAtstring (date-time)required

Uninstall a singleton application

delete/{apiVersion}/installations/{installationId}

Uninstall a singleton from an organization. Sets uninstalledAt and preserves the record for audit history. Requires a service token.

Path parameters

installationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

deletedbooleanrequired

User Applications

Endpoints for managing user applications

Get all user applications

get/{apiVersion}/user-applications/

Retrieves user applications for the given project or organization. Returns an array of applications by default, or a single application when filtering by appHost or default. For studio applications queried via organization route, fetches all projects within the organization.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

appHoststring
Filter by application hostname. When provided, returns a single application instead of an array.
defaultboolean
Filter by default deployment status. When true, returns only the default application as a single object.
appType
Application type. Valid values: studio, coreApp.
dashboardStatus
Dashboard visibility status. Valid values: default, disabled.
includeResourceLinksboolean
When true, includes resource links (e.g. CORS origins) associated with each application.
organizationIdstring
Example:eg4gvkae

Responses

Select response

200

Default Response

Select any

items

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired
resourceLinkstring

Create a user application

post/{apiVersion}/user-applications/

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

appType
Application type. Valid values: studio, coreApp.
organizationIdstring
Example:eg4gvkae

Request body `application/json`

Select one

isDefaultForDeploymentboolean
titlestring
urlTypestringrequired
dashboardStatus
Show child attributes
Select any
string
enum:"default"
appHoststringrequired
autoUpdatingVersion
Show child attributes
Select any
string
enum:"next"

Responses

Select response

200

A user application without deployment information

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null
}

Get workspaces for studio applications

get/{apiVersion}/user-applications/workspaces

Returns a flattened view of user applications with their workspaces. Each workspace becomes a separate entry in the response, allowing easy access to schema descriptors.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

projectIdstring
Filter by project ID. Falls back to the project ID from the request header.
datasetstring
Filter workspaces by dataset name.
namestring
Filter workspaces by workspace name.
keystring
Filter workspaces by workspace key.
appType
Application type. Valid values: studio, coreApp.
organizationIdstring
Example:eg4gvkae

Responses

Select response

200

Response containing flattened workspaces from studio applications

workspacesarrayrequired
Array of workspaces from all studio applications
Show child attributes
items
- keystringrequired
  Unique key combining userApplicationId and workspace name
- userApplicationobjectrequired
  Show child attributes
  idstringrequired
  User application ID
  typestringrequired
  Application type (always studio)
  manifestSource
  Where the workspace manifest was sourced from: "deployment" for active deployment manifest, "live" for live-manifest config
  Show child attributes
  Select any
  string
  enum:"deployment"
- bundleVersionstring
  Version of the Studio bundle from the deployment
- intentBaseUrlstringrequired
  URL for the workspace in the dashboard
- namestringrequired
  Workspace name (default if not specified)
- titlestring
  Display title for the workspace
- resourceobjectrequired
  Show child attributes
  typestringrequired
  Resource type (always dataset)
  idstringrequired
  Resource identifier in format projectId.dataset
- schemaDescriptorIdstringrequired
  Schema descriptor ID from Lexicon

Examplesapplication/json

{
  "workspaces": [
    {
      "key": "app123-default",
      "userApplication": {
        "id": "app123",
        "type": "studio"
      },
      "bundleVersion": "3.40.0",
      "intentBaseUrl": "https://www.sanity.io/@myorg/studio/app123/default",
      "name": "default",
      "title": "My Workspace",
      "resource": {
        "type": "dataset",
        "id": "proj123.production"
      },
      "schemaDescriptorId": "uEiCBsitEg1VROvwEf2khmQEggZ7-qfBKuiah5R63IxV35Q"
    }
  ]
}

Get workspaces for a user application

get/{apiVersion}/user-applications/{userApplicationId}/workspaces

Returns a flattened view of workspaces for a specific user application. Each workspace becomes a separate entry in the response, allowing easy access to schema descriptors.

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

datasetstring
Filter workspaces by dataset name.
namestring
Filter workspaces by workspace name.
keystring
Filter workspaces by workspace key.

Responses

Select response

200

Response containing flattened workspaces from studio applications

workspacesarrayrequired
Array of workspaces from all studio applications
Show child attributes
items
- keystringrequired
  Unique key combining userApplicationId and workspace name
- userApplicationobjectrequired
  Show child attributes
  idstringrequired
  User application ID
  typestringrequired
  Application type (always studio)
  manifestSource
  Where the workspace manifest was sourced from: "deployment" for active deployment manifest, "live" for live-manifest config
  Show child attributes
  Select any
  string
  enum:"deployment"
- bundleVersionstring
  Version of the Studio bundle from the deployment
- intentBaseUrlstringrequired
  URL for the workspace in the dashboard
- namestringrequired
  Workspace name (default if not specified)
- titlestring
  Display title for the workspace
- resourceobjectrequired
  Show child attributes
  typestringrequired
  Resource type (always dataset)
  idstringrequired
  Resource identifier in format projectId.dataset
- schemaDescriptorIdstringrequired
  Schema descriptor ID from Lexicon

Examplesapplication/json

{
  "workspaces": [
    {
      "key": "app123-default",
      "userApplication": {
        "id": "app123",
        "type": "studio"
      },
      "bundleVersion": "3.40.0",
      "intentBaseUrl": "https://www.sanity.io/@myorg/studio/app123/default",
      "name": "default",
      "title": "My Workspace",
      "resource": {
        "type": "dataset",
        "id": "proj123.production"
      },
      "schemaDescriptorId": "uEiCBsitEg1VROvwEf2khmQEggZ7-qfBKuiah5R63IxV35Q"
    }
  ]
}

Get a user application

get/{apiVersion}/user-applications/{userApplicationId}

Get a user application by id

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

A user application with active deployment, manifest data, and config

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null,
  "activeDeployment": null,
  "manifestData": null,
  "config": {
    "live-manifest": {
      "value": {
        "workspaces": [
          {
            "name": "default"
          }
        ]
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "updatedBy": "user_123"
    }
  },
  "manifest": {}
}

Update a user application

patch/{apiVersion}/user-applications/{userApplicationId}

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `application/json`

Select one

title
Show child attributes
Select any
string
isDefaultForDeploymentboolean
urlTypestring
dashboardStatus
Dashboard visibility status. Valid values: default, disabled.
Show child attributes
Select any
string
enum:"default"
autoUpdatingVersion
Show child attributes
Select any
string
enum:"next"

Responses

Select response

200

A user application with active deployment, manifest data, and config

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null,
  "activeDeployment": null,
  "manifestData": null,
  "config": {
    "live-manifest": {
      "value": {
        "workspaces": [
          {
            "name": "default"
          }
        ]
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "updatedBy": "user_123"
    }
  },
  "manifest": {}
}

Delete a user application

delete/{apiVersion}/user-applications/{userApplicationId}

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

deletedbooleanrequired

Delete all user applications

delete/{apiVersion}/projects/{projectId}/user-applications/

Deletes all user applications for a project. Requires a service token

Path parameters

projectIdstringrequired
Example:my-project-id
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

deletedbooleanrequired
deletedCountnumberrequired

Get all user applications for a project

get/{apiVersion}/projects/{projectId}/user-applications/

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appHoststring
Filter by application hostname. When provided, returns a single application instead of an array.
defaultboolean
Filter by default deployment status. When true, returns only the default application as a single object.
appType
Application type. Valid values: studio, coreApp.
dashboardStatus
Dashboard visibility status. Valid values: default, disabled.
includeResourceLinksboolean
When true, includes resource links (e.g. CORS origins) associated with each application.

Responses

Select response

200

Default Response

Select any

items

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired
resourceLinkstring

Create a user application for a project

post/{apiVersion}/projects/{projectId}/user-applications/

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Request body `application/json`

Select one

isDefaultForDeploymentboolean
titlestring
urlTypestringrequired
dashboardStatus
Show child attributes
Select any
string
enum:"default"
appHoststringrequired
autoUpdatingVersion
Show child attributes
Select any
string
enum:"next"

Responses

Select response

200

A user application without deployment information

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null
}

Get a user application for a project

get/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}

Get a user application by id

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Responses

Select response

200

A user application with active deployment, manifest data, and config

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null,
  "activeDeployment": null,
  "manifestData": null,
  "config": {
    "live-manifest": {
      "value": {
        "workspaces": [
          {
            "name": "default"
          }
        ]
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "updatedBy": "user_123"
    }
  },
  "manifest": {}
}

Update a user application for a project

patch/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Request body `application/json`

Select one

title
Show child attributes
Select any
string
isDefaultForDeploymentboolean
urlTypestring
dashboardStatus
Dashboard visibility status. Valid values: default, disabled.
Show child attributes
Select any
string
enum:"default"
autoUpdatingVersion
Show child attributes
Select any
string
enum:"next"

Responses

Select response

200

A user application with active deployment, manifest data, and config

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null,
  "activeDeployment": null,
  "manifestData": null,
  "config": {
    "live-manifest": {
      "value": {
        "workspaces": [
          {
            "name": "default"
          }
        ]
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "updatedBy": "user_123"
    }
  },
  "manifest": {}
}

Delete a user application for a project

delete/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Responses

Select response

200

Default Response

deletedbooleanrequired

Deployments

Endpoints for managing and creating deployments

Legacy deploy route

post/{apiVersion}/deploy

Legacy deploy route used by Sanity CLI. This route should be considered deprecated, and is kept for Sanity CLI compatibility.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

201

Default Response

locationstringrequired

Get user application deployments

get/{apiVersion}/user-applications/{userApplicationId}/deployments

Get deployments for a user application. The response is paginated shape but the actual data is not paginated at this point

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

metaobjectrequired
Show child attributes
- nextCursorrequired
  Show child attributes
  Select any
  null
- totalRecordsnumberrequired
- totalPagesnumberrequired
- pageSizenumberrequired
- pagenumberrequired
deploymentsarrayrequired
Show child attributes
items
- idstringrequired
- versionrequired
  Show child attributes
  Select any
  string
- isActiveDeploymentbooleanrequired
- userApplicationIdstringrequired
- isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
- sizerequired
  Show child attributes
  Select any
  integer
- deployedAtrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- createdAtrequired
- updatedAtrequired
- manifestrequired

Deploy a user application

post/{apiVersion}/user-applications/{userApplicationId}/deployments

Deploys a user application. See Studio Manifest for Studio apps or CoreAppDeploymentManifest for Core Apps.

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

tagstring

Request body `multipart/form-data`

Select one

versionstringrequired
The version of the application being deployed
isAutoUpdatingbooleanrequired
Whether this deployment is from an auto-updating application
tarballstring (binary)required
The tarball containing the built application
manifeststring
JSON manifest for the deployment (optional)

Responses

Select response

201

Default Response

Select one

typestringrequired
deploymentIdstringrequired
locationstringrequired

Get user application deployments for a project

get/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}/deployments

Get deployments for a user application. The response is paginated shape but the actual data is not paginated at this point

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Responses

Select response

200

Default Response

metaobjectrequired
Show child attributes
- nextCursorrequired
  Show child attributes
  Select any
  null
- totalRecordsnumberrequired
- totalPagesnumberrequired
- pageSizenumberrequired
- pagenumberrequired
deploymentsarrayrequired
Show child attributes
items
- idstringrequired
- versionrequired
  Show child attributes
  Select any
  string
- isActiveDeploymentbooleanrequired
- userApplicationIdstringrequired
- isAutoUpdatingrequired
  Show child attributes
  Select any
  boolean
- sizerequired
  Show child attributes
  Select any
  integer
- deployedAtrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- createdAtrequired
- updatedAtrequired
- manifestrequired

Deploy a user application for a project

post/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}/deployments

Deploys a user application. See Studio Manifest for Studio apps or CoreAppDeploymentManifest for Core Apps.

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

tagstring
appType
Application type. Valid values: studio, coreApp.

Request body `multipart/form-data`

Select one

versionstringrequired
The version of the application being deployed
isAutoUpdatingbooleanrequired
Whether this deployment is from an auto-updating application
tarballstring (binary)required
The tarball containing the built application
manifeststring
JSON manifest for the deployment (optional)

Responses

Select response

201

Default Response

Select one

typestringrequired
deploymentIdstringrequired
locationstringrequired

Config

Endpoints for setting user application config

Register a user application config

post/{apiVersion}/user-applications/{userApplicationId}/config/{configKey}

Register a configuration for a user application under the provided key. Only updates when the config value is different from the current value. Note: The supported keys depends on the type of the user application.

Studio Config Keys

live-manifest: See Studio Manifest

Path parameters

userApplicationIdstringrequired
The ID of the user application
configKeystringrequired
The configuration key. Supported values: live-manifest
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `application/json`

valueobjectrequired
Configuration value object
Show child attributes

Responses

Select response

200

Default Response

successbooleanrequired

Register a user application config for a project

post/{apiVersion}/projects/{projectId}/user-applications/{userApplicationId}/config/{configKey}

Studio Config Keys

live-manifest: See Studio Manifest

Path parameters

userApplicationIdstringrequired
The ID of the user application
configKeystringrequired
The configuration key. Supported values: live-manifest
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01
projectIdstringrequired
Example:my-project-id

Query parameters

appType
Application type. Valid values: studio, coreApp.

Request body `application/json`

valueobjectrequired
Configuration value object
Show child attributes

Responses

Select response

200

Default Response

successbooleanrequired

List configs for an installation

get/{apiVersion}/installations/{installationId}/configs

Retrieve the configuration history for an installed singleton. Returns config snapshot metadata ordered by creation date descending.

Path parameters

installationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

limitdefault: 50
Maximum number of results per page (1-100, default 50). Pass "none" to disable pagination.
cursorstring
Cursor from a previous response to fetch the next page

Responses

Select response

200

Default Response

nextCursorrequired
Show child attributes
Select any
string
dataarrayrequired
Show child attributes
items
- idstringrequired
- installationIdstringrequired
- deployedByrequired
  Show child attributes
  Select any
  string
- isActivebooleanrequired
- createdAtstring (date-time)required

Deploy installation configuration

post/{apiVersion}/installations/{installationId}/configs

Push a configuration snapshot to an installed singleton. Creates a new config record and deactivates any previous active config. Requires a session token with sanity.sdk.applications.deploy grant.

Path parameters

installationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Request body `multipart/form-data`

tarballstring (binary)required
Gzipped tarball containing the installation configuration content

Responses

Select response

201

A versioned configuration snapshot for an installation; content is stored in GCS

idstringrequired
installationIdstringrequired
deployedByrequired
Show child attributes
Select any
string
isActivebooleanrequired
createdAtstring (date-time)required

Quick Start

Endpoints for quickstart deployment

Quickstart Deploy

post/{apiVersion}/deploy/quickstart

Quickstart deploy route used by Quickstart. This route is used for a specific experiment and should not be used without prior approval.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

201

Default Response

locationstringrequired

Studio Hosts

Endpoint for query studio host availability

Get appHost availability

get/{apiVersion}/studiohosts/{appHost}/availability

Check if a studio host is available

Path parameters

appHoststringrequired
Example:my-app-host
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

availablebooleanrequired

Get studio auto-updating version status

get/{apiVersion}/user-applications/auto-update-version/{userApplicationId}?

Returns the auto-updating version status for a studio based on the X-App-Host header

Path parameters

userApplicationIdstringrequired
apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Responses

Select response

200

Default Response

autoUpdatingrequired
Whether auto-updating is enabled for internal studios
Show child attributes
Select any
boolean
Whether auto-updating is enabled for internal studios
versionrequired
The auto-updating version to use (one of: next, stable, latest). Defaults to latest if no version is set.
Show child attributes
Select any
string
The auto-updating version to use (one of: next, stable, latest). Defaults to latest if no version is set.

Projects

Endpoints for resolving project

Get project by application

get/{apiVersion}/user-applications/resolve/project

This route is moved from populus, and we have updated services that use it to route to this URL. https://github.com/sanity-io/populus/blob/b460c53cc020a9ca6971c03c45d93bd960196b82/src/controllers/internal/resolve/projects.js Some changes were implemented -- for example, returning a single entity rather than an array.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

appHoststringrequired

Responses

Select response

200

Default Response

idstringrequired
createdByUserIdstringrequired
deletedAtrequired
Show child attributes
Select any
null
displayNamestringrequired
isBlockedbooleanrequired
isDisabledbooleanrequired
isDisabledByUserbooleanrequired
organizationIdstringrequired
organizationrequired
Show child attributes
Select any
requestAccessStatusstringrequired
idstringrequired
namestringrequired
telemetryConsentStatusstringrequired
defaultRoleNamestringrequired
domainsarrayrequired
Show child attributes
items
string
dashboardStatusstringrequired
createdAtstringrequired
updatedAtstringrequired
deletedAtrequired
Show child attributes
Select any
null
createdByUserIdstringrequired

Get application by host

get/{apiVersion}/user-applications/resolve/application

This route is used for internal services to resolve an application by host name.

Path parameters

apiVersionstringrequired
vX:vX
v2025-01-01:v2025-01-01

Query parameters

appHoststringrequired
appType
Application type. Valid values: studio, coreApp.
includeResourceLinksboolean

Responses

Select response

200

A user application with manifest and optional resource links

idstringrequired
projectIdrequired
Show child attributes
Select any
string
organizationIdrequired
Show child attributes
Select any
string
titlerequired
Show child attributes
Select any
string
typerequired
Show child attributes
Select any
string
enum:"studio"
urlTyperequired
Show child attributes
Select any
string
enum:"internal"
appHoststringrequired
dashboardStatusrequired
Show child attributes
Select any
string
enum:"default"
createdAtrequired
updatedAtrequired
autoUpdatingVersionrequired
Show child attributes
Select any
string
activeDeploymentrequired
A deployment of a user application
Show child attributes
Select any
idstringrequired
versionrequired
Show child attributes
Select any
string
isActiveDeploymentbooleanrequired
userApplicationIdstringrequired
isAutoUpdatingrequired
Show child attributes
Select any
boolean
sizerequired
Show child attributes
Select any
integer
deployedAtrequired
deployedByrequired
Show child attributes
Select any
string
createdAtrequired
updatedAtrequired
manifestrequired
manifestDatarequired
Use UserApplicationConfig instead. Key-value data associated with a user application
Show child attributes
Select any
idstringrequired
userApplicationIdstringrequired
typestringrequired
valuerequired
createdAtrequired
updatedAtrequired
configrequired
Show child attributes
Select any
object
manifestrequired
resourceLinkstring

Examplesapplication/json

{
  "id": "app_xyz789",
  "projectId": "proj_123",
  "organizationId": "org_456",
  "title": "My Studio",
  "type": "studio",
  "urlType": "internal",
  "appHost": "my-studio",
  "dashboardStatus": "active",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "autoUpdatingVersion": null,
  "activeDeployment": null,
  "manifestData": null,
  "config": {
    "live-manifest": {
      "value": {
        "workspaces": [
          {
            "name": "default"
          }
        ]
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "updatedBy": "user_123"
    }
  },
  "manifest": {},
  "resourceLink": "https://example.sanity.studio"
}

Studio Manifests

Endpoints for getting studio manifests

Authentication

Base API server URL

Variables

Applications

List applications for an organization

Path parameters

Query parameters

Responses

items

items

items

items

Create an application

Path parameters

Request body multipart/form-data

items

items

Responses

items

items

items

Get an application by ID

Path parameters

Query parameters

Responses

items

items

items

Update an application

Path parameters

Request body application/json

Responses

Delete an application

Path parameters

Responses

Get interfaces by type for an application

Path parameters

Query parameters

Responses

items

Get workspaces for an application

Path parameters

Responses

items

Get resources for an application

Path parameters

Responses

items

List deployments for an application

Path parameters

Query parameters

Responses

items

items

items

items

Deploy an application

Path parameters

Request body multipart/form-data

items

items

Responses

items

items

items

Installations

Install a singleton application

Path parameters

Request body application/json

Responses

Uninstall a singleton application

Path parameters

Responses

User Applications

Get all user applications

Path parameters

Query parameters

Responses

items

Create a user application

Request body `multipart/form-data`

Request body `application/json`

Request body `multipart/form-data`

Request body `application/json`

Request body `application/json`

Request body `application/json`

Request body `application/json`

Request body `application/json`

Request body `multipart/form-data`