Skip to main content
GET
/
v1
/
vault
/
connections
curl 'https://api.picaos.com/v1/vault/connections' \
  -H 'x-pica-secret: YOUR_API_KEY'

{
  "type": "Vault Connections",
  "rows": [
    {
      "id": "673f79c6-0110-408b-bcbe-f4da000e66c7",
      "platformVersion": "1.0.0",
      "name": null,
      "type": "api",
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": "user",
      "description": "Email API for developers",
      "tags": [],
      "version": "1.0.0",
      "active": true,
      "createdAt": "2025-07-19T16:19:29.702632Z"
    },
    ...
  ],
  "total": 20,
  "pages": 2,
  "page": 1
}

​
Query Parameters

​
key
string
A comma separated list of connection keys
​
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)
​
tags
string
A comma separated list of tags
​
active
boolean
default:"true"
Filter connections by active status
​
limit
number
default:"20"
The number of connections to return
​
page
number
default:"1"
The page number

​
Response

​
connections
Connection[]
Array of Connection objects
curl 'https://api.picaos.com/v1/vault/connections' \
  -H 'x-pica-secret: YOUR_API_KEY'

{
  "type": "Vault Connections",
  "rows": [
    {
      "id": "673f79c6-0110-408b-bcbe-f4da000e66c7",
      "platformVersion": "1.0.0",
      "name": null,
      "type": "api",
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": "user",
      "description": "Email API for developers",
      "tags": [],
      "version": "1.0.0",
      "active": true,
      "createdAt": "2025-07-19T16:19:29.702632Z"
    },
    ...
  ],
  "total": 20,
  "pages": 2,
  "page": 1
}
⌘I