Skip to content
API Reference/Workspace API/
/
List workflow executions

Sync Workspace API (1.0.0)

Sync Workspace API

Workspace-specific services for content management, project organization, and file processing.

Workspace Services

The Workspace APIs allow access to the resources contained within Workspaces and Dataspaces. Although Workspaces and Dataspaces are distinct, Dataspaces have no compute of their own, so operations on Dataspace resources must always be performed through a chosen workspace. Workspaces are bundled, fully-managed computational services used to: - Upload, process, and manage content files - Search and retrieve content with advanced filtering - Query content using AI with library citations and web search integration - Run AI workflows on the content - Organize content into projects according to business workflows - Generate file derivatives (images, thumbnails) and extract metadata - Handle content indexing with automated categorization

Content Processing

When files are uploaded, they undergo asynchronous processing which may include: - Virus scanning and security validation - File format conversion and derivative generation (TIFF, JPEG thumbnails) - Automated metadata extraction using AI - Content categorization and indexing according to dataspace ontology Processing status can be tracked using the Workflow Execution API.

Projects vs Content Organization

  • Content: Individual files with metadata, organized by categories defined in the dataspace ontology - Projects: Business workflow containers that group disparate content items according to business rules (e.g., application packets, case files)

Authentication

All endpoints require authentication using a bearer token.

Download OpenAPI description
workspace-openapi.json
workspace-openapi.yaml
Overview
License
Commercial
Languages
Servers
Mock server
https://docs.syncdocs.ai/_mock/api/workspace-openapi/
Production - Workspace Services
https://{workspaceId}.syncdocs.ai/api/
Development server
https://docs.syncdocs.ai/api/

Content

Content management operations. Handle file uploads, processing, metadata extraction, and content retrieval with advanced filtering capabilities.

Operations

Projects

Project management operations. Projects group content items according to business workflows and processes.

Operations

Workflow Executions

Workflow execution monitoring operations. Track the status and progress of AI workflow executions on content.

Operations

List workflow executions

Request

Returns a paginated list of workflow executions. Supports filtering by dataspace ID, status, workflow ID, and content ID. Since workflow executions are stored at the workspace level, dataspace filtering is optional.

Security
bearerAuth
Query
primaryScopeDataspaceIdstring^sds-[a-z0-9]{8}$

Optional filter by dataspace ID

Example: primaryScopeDataspaceId=sds-abc12345
statusstring

Filter by execution status

Enum"started""completed""failed"
Example: status=completed
workflowIdstring(uuid)

Filter by workflow ID

Example: workflowId=987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b
primaryScopeObjectIdstring(uuid)

Filter by primary scope object ID

Example: primaryScopeObjectId=456e7890-e89b-12d3-a456-426614174001
limitinteger[ 1 .. 100 ]

Number of items to return

Default 20
Example: limit=20
offsetinteger or null>= 0

Number of items to skip

Default 0
Example: offset=0
curl -i -X GET \
  'https://docs.syncdocs.ai/_mock/api/workspace-openapi/workflow-executions?primaryScopeDataspaceId=sds-abc12345&status=completed&workflowId=987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b&primaryScopeObjectId=456e7890-e89b-12d3-a456-426614174001&limit=20&offset=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

List of workflow executions retrieved successfully

Bodyapplication/json
itemsArray of objectsrequired
items[].​idstring(uuid)required
Example: "123e4567-e89b-12d3-a456-426614174000"
items[].​workflowIdstring(uuid)required
Example: "987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b"
items[].​primaryScopeObjectIdstring(uuid)required
Example: "456e7890-e89b-12d3-a456-426614174001"
items[].​primaryScopeDataspaceIdstring^sds-[a-z0-9]{8}$required

Short dataspace ID with sds- prefix

Example: "sds-abc12345"
items[].​statusstringrequired
Enum"started""completed""failed"
Example: "completed"
items[].​startedAtstring(date-time)required
Example: "2025-01-15T10:30:00Z"
items[].​completedAtstring or null(date-time)required
Example: "2025-01-15T10:35:00Z"
items[].​errorMessagestring or nullrequired
Example: "Workflow execution failed at step 3"
totalCountinteger>= 0required
Example: 42
limitinteger>= 1required
Example: 20
offsetinteger>= 0required
Example: 0
Response
application/json
{
  "items": [
    { … },
    { … }
  ],
  "totalCount": 2,
  "limit": 20,
  "offset": 0
}

Get workflow execution by ID

Request

Returns detailed information about a specific workflow execution, including all associated TaskExecution objects that represent the individual tasks that were executed as part of this workflow.

Security
bearerAuth
Path
workflowExecutionIdstring(uuid)required

UUID of the workflow execution

Example: 123e4567-e89b-12d3-a456-426614174000
curl -i -X GET \
  https://docs.syncdocs.ai/_mock/api/workspace-openapi/workflow-executions/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Workflow execution details retrieved successfully

Bodyapplication/json
idstring(uuid)required
Example: "123e4567-e89b-12d3-a456-426614174000"
workflowIdstring(uuid)required
Example: "987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b"
primaryScopeObjectIdstring(uuid)required
Example: "456e7890-e89b-12d3-a456-426614174001"
primaryScopeDataspaceIdstring^sds-[a-z0-9]{8}$required

Short dataspace ID with sds- prefix

Example: "sds-abc12345"
statusstringrequired
Enum"started""completed""failed"
Example: "completed"
startedAtstring(date-time)required
Example: "2025-01-15T10:30:00Z"
completedAtstring or null(date-time)required
Example: "2025-01-15T10:35:00Z"
errorMessagestring or nullrequired
Example: "Workflow execution failed at step 3"
taskExecutionsArray of objectsrequired

List of task executions within this workflow execution

Example: []
taskExecutions[].​idstring(uuid)required
Example: "789e0123-e89b-12d3-a456-426614174002"
taskExecutions[].​workflowExecutionIdstring(uuid)required
Example: "123e4567-e89b-12d3-a456-426614174000"
taskExecutions[].​taskDefinitionIdstring(uuid)required
Example: "abc1234d-e89b-12d3-a456-426614174003"
taskExecutions[].​taskNamestringrequired
Example: "Categorize Document"
taskExecutions[].​primaryScopeObjectIdstring(uuid)required
Example: "456e7890-e89b-12d3-a456-426614174001"
taskExecutions[].​primaryScopeDataspaceIdstring^sds-[a-z0-9]{8}$required

Short dataspace ID with sds- prefix

Example: "sds-abc12345"
taskExecutions[].​statusstringrequired
Enum"started""completed""failed"
Example: "completed"
taskExecutions[].​startedAtstring(date-time)required
Example: "2025-01-15T10:30:30Z"
taskExecutions[].​completedAtstring or null(date-time)required
Example: "2025-01-15T10:32:00Z"
taskExecutions[].​errorMessagestring or nullrequired
Example: "Task failed due to invalid input format"
Response
application/json
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workflowId": "987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b",
  "primaryScopeObjectId": "456e7890-e89b-12d3-a456-426614174001",
  "primaryScopeDataspaceId": "sds-abc12345",
  "status": "completed",
  "startedAt": "2025-01-15T10:30:00Z",
  "completedAt": "2025-01-15T10:35:00Z",
  "errorMessage": null,
  "taskExecutions": [
    { … }
  ]
}

Batch Workflow Executions

Batch workflow execution operations. Execute workflows on multiple content items based on filters across multiple dataspaces.

Operations

Task Executions

Task execution monitoring operations. Track individual task executions within workflows and retrieve their outputs.

Operations

Task Execution Outputs

Task execution output retrieval operations. Access the results and outputs generated by completed task executions.

Operations

Registered Workflows

Registered workflow operations. Access workflows cached from sync-apis for fast lookup during workflow execution.

Operations

Query Logs

Query logging and retrieval operations. Track and analyze API operations performed on resources with detailed audit trails.

Operations

Content Upload Sessions

Content upload session management operations. Handle reliable file uploads through chunked upload sessions with progress tracking.

Operations