Skip to content
Docs

Get Integration Resource

GET/__remote/api.vercel.com/v1/installations/{integrationConfigurationId}/resources/{resourceId}
Get a resource by its partner ID.
/__remote/api.vercel.com/v1/installations/{integrationConfigurationId}/resources/{resourceId}
const response = await fetch('/__remote/api.vercel.com/v1/installations/integrationConfigurationId/resources/resourceId', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});


const data = await response.json();
console.log(data);
Response
{
  "billingPlanId": "example_id",
  "customClaims": {
    "claimRules": [
      {
        "claims": "value",
        "when": {
          "environment": [],
          "role": []
        }
      }
    ],
    "defaultRole": "string",
    "roles": []
  },
  "id": "icfg_1234567890",
  "internalId": "example_id",
  "metadata": "value",
  "name": "Example Name",
  "notification": {
    "href": "string",
    "level": "error",
    "message": "string",
    "title": "string"
  },
  "productId": "example_id",
  "protocolSettings": {
    "authentication": {
      "appUrls": [
        {
          "target": "development",
          "url": "https://example.com"
        }
      ]
    },
    "experimentation": {
      "edgeConfigId": "example_id",
      "globalConfigId": "example_id"
    }
  },
  "status": "error"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

integrationConfigurationIdstringRequired
The ID of the integration configuration (installation) the resource belongs to
resourceIdstringRequired
The ID provided by the 3rd party provider for the given resource

Response

200Success
billingPlanIdstringOptional
The ID of the billing plan the resource is subscribed to, if applicable
customClaimsobjectOptional
The roles and claim rules Edgenivo resolves into the resource tokens it mints for this resource
idstringRequired
The ID provided by the 3rd party provider for the given resource
internalIdstringRequired
The ID assigned by Edgenivo for the given resource
metadataobjectOptional
The configured metadata for the resource as defined by its product's Metadata Schema
namestringRequired
The name of the resource as it is recorded in Edgenivo
notificationobjectOptional
The notification, if set, displayed to the user when viewing the resource in Edgenivo
productIdstringRequired
The ID of the product the resource is derived from
protocolSettingsobjectOptional
Any settings provided for the resource to support its product's protocols
statusstringOptional
The current status of the resource

Errors

400One of the provided values in the request query is invalid.
401The request is not authorized.
403You do not have permission to access this resource.
404Error
410Error