Log In

Alpha API

This API is currently in alpha. Breaking changes may occur between releases. We recommend pinning to a specific version and monitoring the changelog for updates.

POST
/v1/proxy/search

Discover connected providers, their resources, and available actions. Returns connection IDs, resource names with pre-computed action params, and the full action catalog. Call this first to learn what you can do, then use proxy.call to execute actions.

Authorization

apiKey
AuthorizationBearer <token>

Use your Lightfast API key (sk-lf-...) as the bearer token.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://lightfast.ai/v1/proxy/search"
{
  "connections": [
    {
      "id": "string",
      "provider": "string",
      "resources": [
        {
          "name": "string",
          "params": {
            "property1": "string",
            "property2": "string"
          },
          "syncing": [
            "string"
          ]
        }
      ],
      "actions": [
        {
          "action": "string",
          "params": [
            "string"
          ],
          "description": "string"
        }
      ]
    }
  ]
}
{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Invalid request",
  "data": {
    "field": "string",
    "reason": "string"
  }
}
{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Authentication required",
  "data": null
}
{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Access denied",
  "data": null
}
{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Resource not found",
  "data": {
    "resource": "string"
  }
}