Workflow Management Service

Model business processes with stages and transitions, run workflow items through their lifecycle, and keep reference data, managed records, and files alongside your workflows. A multi-tenant REST API designed for integrations, portals, and operational tools.

Scroll to explore

Quick start

All endpoints are under your tenant. Obtain a bearer token from Agglestone Authentication, then call the Workflow API with /tenant/{tenantId}/v1/....

// List workflow definitions (GET)
const baseUrl = 'https://workflow.agglestone.com';
const tenantId = 'your-tenant-id';
const token = 'your-access-token';

const res = await fetch(
  `${baseUrl}/tenant/${tenantId}/v1/Workflows?pageSize=20`,
  { headers: { 'Authorization': `Bearer ${token}` } }
);
const definitions = await res.json();

Create definitions, start items, transition stages, attach files, and query reference or managed data using the same tenant-scoped base path. Open Swagger UI on this host for full request schemas.

What you can build

Use one consistent API surface for workflow-driven applications without operating your own workflow engine.

Workflow definitions

Author stages, transitions, field rules, JSON schemas, and permissions. Version definitions as your process evolves.

Workflow items

Create items from a definition, update fields, transition between stages, roll back when allowed, and inspect full history.

Bulk operations

Batch inserts, updates, transitions, and deletes in a single request for high-throughput or migration scenarios.

Reference data

Shared lookup lists and hierarchical selections for forms and dropdowns, scoped per tenant.

Managed data

Reusable business records with JSON-schema-backed fields and their own lifecycle alongside workflows.

Files

Upload files, read metadata, and issue short-lived signed URLs for direct browser access to stored blobs.

Utilities

Public holiday lookups to drive deadlines, SLAs, and calendar-aware workflow behaviour.

OpenAPI

Explore and try the contract interactively via Swagger on this service. Ideal for codegen and integration testing.

Multi-tenant by design

Every request includes your tenant in the path. Workflow definitions, items, reference data, managed data, and files stay isolated per tenant.

https://workflow.agglestone.com/tenant/{tenantId}/v1/Workflows
https://workflow.agglestone.com/tenant/{tenantId}/v1/Workflows/{definitionId}/Items

Need your tenant ID? Sign in to the Agglestone Portal.