Skip to main content
GET
{BASE_URL}
/
api
/
runtime
/
process-instance
/
{processInstanceUuid}
/
build
/
info
curl -X GET "{BASE_URL}/api/runtime/process-instance/{processInstanceUuid}/build/info" \
  -H "Authorization: Bearer <token>"
Looking for end-to-end guidance on calling FlowX from your own app? See Consuming FlowX from external apps.
Returns the build that an already-started process instance is running on, with its associated build settings. Renderers call this when continuing a process across page refreshes; an external app would call it to discover the build version a process started against (for example, before fetching media files, substitution tags, or theme assets keyed by build). The runtime resolves authorisation by checking that the process instance belongs to a workspace inside your organisation.

​
Path parameters

​
processInstanceUuid
string
required
The UUID of the process instance.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer <token>.

​
Response

Returns a BuildInfoDTO with the build identifier, the workspace that owns it, and the build settings (theme, platforms, locale defaults, formatting). 
{
  "workspaceId": "2ae77b6a-d284-4a0b-ab23-ceaa364c7122",
  "buildId": "7d5560be-3846-49fa-9c17-4059c54c7c5f",
  "applicationId": "dbe0ab87-539b-4015-962d-6e73226b9e58",
  "buildSettings": {
    "applicationVersionId": "99f24e3f-e331-48ad-a503-2cc1cee5fb95",
    "platforms": "OMNICHANNEL",
    "themeId": "12345678-1234-1234-1234-123456789012",
    "defaultLanguageCode": "en"
  }
}

curl -X GET "{BASE_URL}/api/runtime/process-instance/{processInstanceUuid}/build/info" \
  -H "Authorization: Bearer <token>"
Last modified on May 5, 2026