Skip to content
/
List configurations
Last updated

List Personal Connector Configurations

🔨 In Development — This section is still being developed and may change.
Retrieve a list of all personal connector configurations for the authenticated user or API key. These configurations represent the user's specific setups for external services.
GEThttps://api.freddy.aitronos.com/v1/personal-connectors/configurations

This endpoint returns a paginated list of PersonalConnectorConfiguration objects that belong to the authenticated user or API key. You can filter by connector type, enabled status, and more.

Query Parameters

personalConnectorId string optional Filter by specific personal connector ID (e.g., pcon_github, pcon_clickup).

enabled boolean optional Filter by enabled status. If true, returns only enabled configurations. If false, returns only disabled configurations.

healthStatus string optional Filter by health status. Values: healthy, unhealthy, unknown.

limit integer optional · Defaults to 20 A limit on the number of objects to be returned. Limit can range between 1 and 100.

after string optional A cursor for use in pagination. after is an object ID that defines your place in the list.

Bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "pconf_abc123",
      "object": "personal_connector.configuration",
      "userId": "user_xyz789",
      "apiKeyId": null,
      "organizationId": "org_123",
      "personalConnectorId": "pcon_github",
      "name": "My Backend Repo",
      "configuration": {
        "repository": "aitronos/freddy-backend",
        "branch": "main",
        "paths": ["src/", "docs/"]
      },
      "credentials": "***REDACTED***",
      "enabled": true,
      "healthStatus": "healthy",
      "lastSyncAt": "2025-10-07T10:45:00Z",
      "lastError": null,
      "description": "Access to Freddy Backend repository for AI assistance.",
      "metadata": {},
      "createdAt": "2025-10-07T10:45:00Z",
      "updatedAt": "2025-10-07T10:45:00Z"
    },
    {
      "id": "pconf_def456",
      "object": "personal_connector.configuration",
      "userId": "user_xyz789",
      "apiKeyId": null,
      "organizationId": "org_123",
      "personalConnectorId": "pcon_clickup",
      "name": "My ClickUp Tasks",
      "configuration": {
        "workspaceId": "12345678",
        "defaultListId": "987654321"
      },
      "credentials": "***REDACTED***",
      "enabled": true,
      "healthStatus": "healthy",
      "lastSyncAt": "2025-10-07T11:00:00Z",
      "lastError": null,
      "shared": false,
      "sharedWith": null,
      "description": "Personal ClickUp integration for task management.",
      "metadata": {},
      "createdAt": "2025-10-07T10:50:00Z",
      "updatedAt": "2025-10-07T11:00:00Z"
    }
  ],
  "has_more": false
}
Previous page
Next page