curl --request POST \
--url https://api.mixpeek.com/v1/organizations/connections/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "List active Google Drive connections",
"is_active": true,
"provider_type": "google_drive"
}
'import requests
url = "https://api.mixpeek.com/v1/organizations/connections/list"
payload = {
"description": "List active Google Drive connections",
"is_active": True,
"provider_type": "google_drive"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: 'List active Google Drive connections',
is_active: true,
provider_type: 'google_drive'
})
};
fetch('https://api.mixpeek.com/v1/organizations/connections/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixpeek.com/v1/organizations/connections/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'description' => 'List active Google Drive connections',
'is_active' => true,
'provider_type' => 'google_drive'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mixpeek.com/v1/organizations/connections/list"
payload := strings.NewReader("{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mixpeek.com/v1/organizations/connections/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixpeek.com/v1/organizations/connections/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}"
response = http.request(request)
puts response.read_body{
"description": "Paginated list response",
"pagination": {
"page": 1,
"page_size": 10,
"total": 10,
"total_pages": 1
},
"results": [
{
"connection_id": "conn_abc123",
"is_active": true,
"name": "Marketing Drive",
"provider_type": "google_drive",
"status": "active"
}
],
"total": 10
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}List Storage Connections
List storage connections for the authenticated organization.
Returns paginated results with optional filters for provider type, status, and active flag. Results are sorted by creation date (newest first).
Use Cases:
- List all active Google Drive connections
- Find failed connections that need attention
- Filter by provider type for sync configuration
Example:
curl -X POST "http://localhost:8000/v1/organizations/connections/list" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider_type": "google_drive",
"is_active": true
}'
curl --request POST \
--url https://api.mixpeek.com/v1/organizations/connections/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "List active Google Drive connections",
"is_active": true,
"provider_type": "google_drive"
}
'import requests
url = "https://api.mixpeek.com/v1/organizations/connections/list"
payload = {
"description": "List active Google Drive connections",
"is_active": True,
"provider_type": "google_drive"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: 'List active Google Drive connections',
is_active: true,
provider_type: 'google_drive'
})
};
fetch('https://api.mixpeek.com/v1/organizations/connections/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixpeek.com/v1/organizations/connections/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'description' => 'List active Google Drive connections',
'is_active' => true,
'provider_type' => 'google_drive'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mixpeek.com/v1/organizations/connections/list"
payload := strings.NewReader("{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mixpeek.com/v1/organizations/connections/list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixpeek.com/v1/organizations/connections/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"List active Google Drive connections\",\n \"is_active\": true,\n \"provider_type\": \"google_drive\"\n}"
response = http.request(request)
puts response.read_body{
"description": "Paginated list response",
"pagination": {
"page": 1,
"page_size": 10,
"total": 10,
"total_pages": 1
},
"results": [
{
"connection_id": "conn_abc123",
"is_active": true,
"name": "Marketing Drive",
"provider_type": "google_drive",
"status": "active"
}
],
"total": 10
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"error": {
"details": {
"id": "ns_123",
"resource": "namespace"
},
"message": "Namespace not found",
"type": "NotFoundError"
},
"status": 404,
"success": false
}Authorizations
Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.
Query Parameters
1 <= x <= 10001 <= x <= 10000 <= x <= 10000x >= 1Body
Request payload for listing storage connections with filters.
Use this to filter connections by provider type, status, or active flag. Results are paginated automatically.
Use Cases:
- List all active Google Drive connections
- Find failed connections that need attention
- Filter by provider type for sync configuration
Examples:
# List all active Google Drive connections { "provider_type": "google_drive", "is_active": True } # Find failed connections { "status": "failed" }
OPTIONAL. Filter connections by provider type. Supported: google_drive, s3, snowflake, sharepoint, tigris. If not provided, returns connections of all types.
google_drive, s3, snowflake, sharepoint, tigris, postgresql, instagram, tiktok, rss, http_api, box, brightdata, backblaze, mux, email, supabase, iconik, gcs, azure_blob, rtsp "google_drive"
OPTIONAL. Filter connections by operational status. ACTIVE: Healthy and ready for use. SUSPENDED: Temporarily disabled. FAILED: Health checks failing. ARCHIVED: Permanently retired.
PENDING, QUEUED, IN_PROGRESS, PROCESSING, COMPLETED, COMPLETED_WITH_ERRORS, FAILED, CANCELED, INTERRUPTED, UNKNOWN, SKIPPED, DRAFT, ACTIVE, ARCHIVED, SUSPENDED, DEACTIVATED OPTIONAL. Filter by active flag. True: Returns only active connections (status=ACTIVE). False: Returns only inactive connections (SUSPENDED/FAILED/ARCHIVED). If not provided, returns connections of all active states.
Response
Successful Response
Response envelope for listing storage connections.
Contains paginated results and metadata about the listing operation.
List of storage connections matching the request filters. Results are paginated according to the pagination parameters. SECURITY: Sensitive credential fields are automatically redacted.
Show child attributes
Show child attributes
Pagination metadata including total count, page number, page size, and navigation links for next/previous pages.
Show child attributes
Show child attributes
Total number of connections matching the filters (before pagination). Use this to calculate total pages and display pagination controls.
x >= 00
5
42
Was this page helpful?

