Common questions

Frequently Asked Questions

Everything you need to know about Priostack's pricing, compatibility, and execution model.

Billing & Credits

What counts as "1 credit"?

One credit is deducted each time a workflow instance is started (POST /api/v1/process-instances). Service tasks, user tasks, and gateways within that instance are included at no extra cost — there's no per-task fee.

Is there a monthly subscription?

No. Credits are one-time packs you buy and use at your own pace. There is no monthly fee, no seat pricing, and no idle cost. If you don't run workflows in a given month, you pay nothing.

Do credits expire?

Yes. Purchased credits are valid for 30 days from the date of purchase. Free signup credits also expire after 30 days. You'll receive an email reminder before expiry.

Expired credits are not refundable, so we recommend buying packs that match your near-term usage rather than stocking up.

What happens when my credits run out?

The API returns 402 Payment Required when your balance reaches zero. Pending jobs remain in the queue — no work is lost. Top up your credits and polling workers will resume picking them up automatically.

Can I get a refund on unused credits?

Credit packs are non-refundable once purchased. If you have questions about your bill or a specific charge, contact support@priostack.com and we'll review it on a case-by-case basis.

BPMN Compatibility

Do I need to change my BPMN files?

No. Any standard BPMN 2.0 file works with Priostack. Task definition extension elements (<taskDefinition type="...">) are fully supported for routing jobs to your workers.

Which BPMN elements are supported?

Priostack supports the core BPMN 2.0 execution subset: start/end events, service tasks, user tasks, exclusive gateways, parallel gateways, sequence flows, and message/signal events.

More complex elements (sub-processes, compensation, ad-hoc) are on the roadmap. Check the API docs for the current compatibility matrix.

Is there a limit on process complexity?

A single process definition cannot contain more than 150 flow nodes (service tasks, user tasks, gateways, and all other flow elements combined). This limit ensures predictable execution performance and cost per instance.

Processes exceeding this limit are rejected at deployment time with a clear error message — your other processes are not affected.

Does it work with monitoring and task-list UIs?

Yes. Priostack exposes the standard Operate and Tasklist-compatible REST API surface — /api/v1/process-instances, /api/v1/incidents, and a GraphQL endpoint at /api/v1/graphql for human tasks. Configure any compatible client to point at https://priostack.com/api/v1.

Execution Engine

What's the unique "deadlock detection" feature?

Priostack's execution engine performs a structural analysis of your process model at deployment time and can detect deadlocks — situations where a token can enter a state from which the workflow can never reach an end event.

Deadlocked instances appear automatically in GET /api/v1/incidents so you can fix the process model before it affects production.

What happens to in-flight instances during an outage?

Priostack persists the state of every process instance. If the service restarts, in-flight instances resume from their last persisted checkpoint. Jobs that were activated before the restart re-appear in the queue once workers poll again.

Is there a timeout for long-running service tasks?

Yes. When you activate a job with POST /api/v1/jobs/activate you set a timeout in milliseconds. If the worker doesn't complete or fail the job within that window, the lock is released and the job becomes available for another worker to pick up.

Getting Started

How do I get an API key?

Enter your email on the homepage signup form. Your API key will be shown on the page and emailed to you instantly. No credit card required — you receive 100 free instance credits on signup.

How do I connect my BPMN modeler?

In your modeler's connection settings (Gateway / Endpoint), set the cluster address to https://priostack.com and the REST endpoint to /api/v1. Use your API key as the bearer token. That's it — deploy and run as normal.

Can I use the API directly without a modeler?

Absolutely. Priostack is a plain JSON REST API. See the API reference for full details, or jump straight into the curl examples on the homepage.

Still have questions?

Chat with us on Telegram or drop us an email — we typically reply within one business day.