StudioHomepage
ServicesApplicationsHTTP APIInstallations

Suspend or resume an installation

PUT
/api/apps/installations/{installation_id}/status

Suspend or resume an approved installation. Only an Organization owner can change it. A suspended installation stops at its next request, even with an unexpired token.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Path Parameters

installation_id*string

Request Body

application/json
  1. body
enabled*boolean

Response Body

Success

application/json
  1. response

An Application installed in one Organization, where it acts as its own identity. requested is the latest request. approved is what an Organization owner approved, and it is the only grant that Spiral enforces. A request for more access takes effect only when an owner approves it.

applicationId*string
approved?|null
id*string
organizationId*string
requested*
status*apps.InstallationStatus
Value in"requested""active""suspended"
curl -X PUT 'https://api.spiraldb.dev/api/apps/installations/string/status' \  -H 'Content-Type: application/json' \  -d '{  "enabled": true}'
{  "applicationId": "string",  "approved": {    "projects": {      "all": true,      "projectIds": [        "string"      ]    },    "scopes": [      "string"    ]  },  "id": "string",  "organizationId": "string",  "requested": {    "projects": {      "all": true,      "projectIds": [        "string"      ]    },    "scopes": [      "string"    ]  },  "status": "requested"}