Skip to main content

List User Flows

This endpoint allows authenticated users to retrieve all flows they have been granted access to by administrators.

Endpoint​

GET /api/v1/langflow/flows

Authentication​

Requires User authentication:

  • Valid JWT token
  • User must have an API key and flow permissions

Request Format​

No request body required for this GET endpoint.

Example Request​

curl --location 'https://8ehqmu89grlsbn-8001.proxy.runpod.net/api/v1/langflow/flows' \
--header 'Authorization: Bearer YOUR_JWT_TOKEN'

Response Format​

Success Response​

Status Code: 200 OK

Returns an array of flows the user has access to.

[
  "550e8400-e29b-41d4-a716-446655440000",
  "660f9511-f3ac-52e5-b827-557766551111",
  "770g0622-g4bd-63f6-c938-668877662222"
]

Response Fields​

The response is an array of flow IDs (strings) that the user has permission to access.

Error Responses​

Unauthorized​

Status Code: 401 Unauthorized

This occurs when the JWT token is missing, invalid, or the user ID cannot be extracted.

{
  "error": "Unauthorized access"
}

Forbidden​

Status Code: 403 Forbidden

This occurs when the user doesn't have an API key or any flow permissions.

{
  "error": "No API key found for user"
}

Service Unavailable​

Status Code: 503 Service Unavailable

{
  "error": "Permissions store not initialized"
}

Server Error​

Status Code: 500 Internal Server Error

{
  "error": "Internal server error"
}

Notes​

  • Only authenticated users can access this endpoint
  • Users must have been granted access to flows by an administrator
  • Returns only flow IDs, not complete flow data
  • Empty array [] is returned if the user has no flow permissions
  • The user's API key must exist and be valid
  • Flow permissions are managed through the admin endpoints
  • This endpoint is typically used by client applications to determine which flows to display to users
  • The actual flow execution would use the user's API key with Langflow directly