GET
/
v1
/
vault
/
connections
curl --location --request GET 'https://api.picaos.com/v1/vault/connections' \
--header 'x-pica-secret: YOUR_API_KEY'
{
  "type": "Vault Connections",
  "rows": [
    {
      "_id": "conn::GC6icwVKcco::Tao3acOXT366-S40uINMxw",
      "platformVersion": "1.0.0",
      "name": null,
      "type": {
          "api": {}
      },
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": null,
      "description": "Email API for developers",
      "createdAt": 1742508720866,
      "updatedAt": 1742508720866,
      "updated": false,
      "version": "1.0.0",
      "lastModifiedBy": "system",
      "deleted": false,
      "active": true,
      "deprecated": false
    },
    ...
  ],
  "total": 39,
  "skip": 0,
  "limit": 20
}

Query Parameters

key
string

The connection key

platformVersion
string

The platform version

name
string

The connection name

identityType
"user" | "team" | "organization" | "project"

The identity type

identity
string

The connection identifier

platform
string

The connector platform (e.g. stripe, exa)

active
boolean
default:"true"

Filter connections by active status

limit
number
default:"20"

The number of connections to return

skip
number
default:"0"

The number of connections to skip

Response

connections
Connection[]

Array of Connection objects

curl --location --request GET 'https://api.picaos.com/v1/vault/connections' \
--header 'x-pica-secret: YOUR_API_KEY'
{
  "type": "Vault Connections",
  "rows": [
    {
      "_id": "conn::GC6icwVKcco::Tao3acOXT366-S40uINMxw",
      "platformVersion": "1.0.0",
      "name": null,
      "type": {
          "api": {}
      },
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": null,
      "description": "Email API for developers",
      "createdAt": 1742508720866,
      "updatedAt": 1742508720866,
      "updated": false,
      "version": "1.0.0",
      "lastModifiedBy": "system",
      "deleted": false,
      "active": true,
      "deprecated": false
    },
    ...
  ],
  "total": 39,
  "skip": 0,
  "limit": 20
}