VercelVercel
Menu

Update Resource

PATCH/v1/installations/{installationId}/resources/{resourceId}
Updates a resource
/v1/installations/{installationId}/resources/{resourceId}
const response = await fetch('/v1/installations/string/resources/string', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "string",
    "metadata": "value",
    "billingPlanId": "string",
    "status": "ready",
    "protocolSettings": {
      "experimentation": {
        "edgeConfigId": "string"
      }
    }
  }),
});


const data = await response.json();
console.log(data);
Response
{
  "id": "string",
  "productId": "string",
  "protocolSettings": {
    "experimentation": {
      "edgeConfigSyncingEnabled": "true",
      "edgeConfigId": "string",
      "edgeConfigTokenId": "string"
    }
  },
  "billingPlan": {
    "id": "string",
    "type": "prepayment",
    "name": "string",
    "scope": "installation",
    "description": "string",
    "paymentMethodRequired": "true",
    "preauthorizationAmount": "123",
    "initialCharge": "string",
    "minimumAmount": "string",
    "maximumAmount": "string",
    "maximumAmountAutoPurchasePerPeriod": "string",
    "cost": "string",
    "details": [],
    "highlightedDetails": [],
    "quote": [],
    "effectiveDate": "string",
    "disabled": "true"
  },
  "name": "string",
  "metadata": "value",
  "status": "ready",
  "notification": {
    "level": "info",
    "title": "string",
    "message": "string",
    "href": "string"
  }
}

Authentication

AuthorizationUser Authentication

Default authentication mechanism

Path parameters

installationIdstringRequired
resourceIdstringRequired

Header parameters

X-Vercel-AuthstringOptional
The auth style used in the request (system, user, etc)
Idempotency-KeystringOptional
A unique key to identify a request across multiple retries

Request

This endpoint expects an object.

namestringOptional
User-inputted name for the resource.
metadataobjectOptional
User-inputted metadata based on the registered metadata schema.
billingPlanIdstringOptional
Partner-provided billing plan. Example: "pro200"
statusstringOptional
Deprecated
protocolSettingsobjectOptional

Response

Return the updated resource
idstringRequired
The partner-specific ID of the resource
productIdstringRequired
The partner-specific ID/slug of the product. Example: "redis"
protocolSettingsobjectOptional
billingPlanobjectOptional
The billing plan for the resource. If not set, the resource is billed on installation level.
namestringRequired
User-inputted name for the resource.
metadataobjectRequired
User-inputted metadata based on the registered metadata schema.
statusstringRequired
notificationobjectOptional
Resource's active notification. Example: { "level": "warn", "title": "Database is nearing maximum planned size" }

Errors

400Input has failed validation
403Operation failed because the authentication is not allowed to perform this operation
409Operation failed because of a conflict with the current state of the resource
Update Resource | Partner API