Retrieve workflows.
Retrieve the workflows for the current workspace.
HTTP
GET https://hostname/v1/workflows
Request Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page |
integer | No | Retrieves parameter page used to refine the request; expected type is integer. |
limit |
integer | No | Retrieves parameter limit used to refine the request; expected type is integer. |
sort |
array[string] | No | Retrieves parameter sort used to refine the request; expected type is array[string]. |
Request Body
No request body.
Request Examples
Each example shows how to call this endpoint with the documented method, URL, headers, and request body format.
curl -X GET "/v1/workflows" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
fetch("/v1/workflows", {
method: "GET",
headers: {
"Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
})
.then(res => res.json())
.then(data => console.log(data));
import json
import requests
url = "/v1/workflows"
headers = {
"Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
payload = None
response = requests.get(url, headers=headers)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
body := http.NoBody
req, _ := http.NewRequest("GET", "/v1/workflows", body)
req.Header.Set("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body2, _ := io.ReadAll(resp.Body)
fmt.Println(string(body2))
}
Response Parameters
The response returns a WorkflowSummaryPage object. For complete field descriptions and schema definition, see the schema reference.
Response
Behavior: The request completed successfully. Success.
{
"items": [
{
"...": "..."
}
],
"totalPages": 0,
"totalItems": 0,
"currentPage": 0,
"pageSize": 0
}
Behavior: The request contains invalid or missing fields. Review the error details and correct the request before retrying.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}
Behavior: Authentication failed. Verify that your API key and bearer token are present and valid.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}
Behavior: Access is denied. Verify that your account has the required permissions for this operation.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}
Behavior: An unexpected error occurred on the server. If the problem persists, contact support.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}
Success responses
Behavior: Success.
{
"items": [
{
"...": "..."
}
],
"totalPages": 0,
"totalItems": 0,
"currentPage": 0,
"pageSize": 0
}Error responses
What to do: Review path, query, header, and body values. Correct invalid fields and retry the request.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}What to do: Verify credentials or token validity, then resend the request.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}What to do: Verify permissions and access scope for this operation. Contact an administrator if access should be granted.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}What to do: Retry after a short delay. If the issue persists, collect error identifiers from the payload and contact support.
{
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errorCode": "string"
}