connectors

Embed
Preview of the card
<a href="https://hermeticor.com/docs/ref-connectors"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/b2c0834c-9a8e-4b46-af78-fde29588720f/social-card.svg?v=3e7ae33eec8b" alt="connectors" width="600" height="315"></a>
GEThttps://hermeticor.com/v1/integrations/packages

Parameters

limitintegerquery
Page size; omitted returns the whole list
cursorstringquery
Opaque: the nextCursor of the previous page

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/integrations/packages" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "items": [
    {
      "packageId": "string",
      "version": "string",
      "name": "string",
      "publisher": "string",
      "summary": "string",
      "reviewStatus": "string",
      "installedAt": "2024-01-01T00:00:00Z",
      "updatedAt": "2024-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}
Schema
itemsItemsItem105[]required
Show child parameters
packageIdstringrequired
versionstringrequired
namestringrequired
publisherstringrequired
summarystringrequired
reviewStatusstringrequired
installedAtstringrequired
updatedAtstringrequired
nextCursorstringrequired
4XX Default Response
Example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
Schema
errorobjectrequired
Show child parameters
codestringrequired
messagestringrequired
detailsobject
5XX Default Response

Same as 4XX · GET /v1/integrations/packages

POSThttps://hermeticor.com/v1/integrations/packages

Install one catalogue package version; unsigned, mis-signed or unreviewed packages are refused

Request body

application/json
packageIdstringrequired
versionstringrequired
{
  "packageId": "string",
  "version": "string"
}

Code samples

cURL
curl -X POST "https://hermeticor.com/v1/integrations/packages" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"string","version":"string"}'
TypeScript
Python
Go
PHP
Ruby
Java

Responses

201 Default Response
Example
{
  "packageId": "string",
  "version": "string",
  "name": "string",
  "publisher": "string",
  "summary": "string",
  "reviewStatus": "string",
  "installedAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}
Schema
packageIdstringrequired
versionstringrequired
namestringrequired
publisherstringrequired
summarystringrequired
reviewStatusstringrequired
installedAtstringrequired
updatedAtstringrequired
4XX Default Response

Same as 4XX · GET /v1/integrations/packages

5XX Default Response

Same as 4XX · GET /v1/integrations/packages

POSThttps://hermeticor.com/v1/integrations/packages/{packageId}/upgrade

Move an installed package (and every connection using it) to another verified version

Parameters

packageIdstringpathrequired

Request body

application/json
versionstringrequired
{
  "version": "string"
}

Code samples

cURL
curl -X POST "https://hermeticor.com/v1/integrations/packages/{packageId}/upgrade" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":"string"}'
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response

Same as 201 · POST /v1/integrations/packages

4XX Default Response

Same as 4XX · GET /v1/integrations/packages

5XX Default Response

Same as 4XX · GET /v1/integrations/packages

DELETEhttps://hermeticor.com/v1/integrations/packages/{packageId}

Uninstall; refused while connections use it

Parameters

packageIdstringpathrequired

Code samples

cURL
curl -X DELETE "https://hermeticor.com/v1/integrations/packages/{packageId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "ok": true
}
Schema
okbooleanrequired
true
4XX Default Response

Same as 4XX · GET /v1/integrations/packages

5XX Default Response

Same as 4XX · GET /v1/integrations/packages

GEThttps://hermeticor.com/integrations/x/callback

Parameters

typequery
additionalPropertiesstringquery

Code samples

cURL
curl -X GET "https://hermeticor.com/integrations/x/callback"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
"string"
4XX Default Response

Same as 4XX · GET /v1/integrations/packages

5XX Default Response

Same as 4XX · GET /v1/integrations/packages

Updated