> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Build Info

> Retrieve the active build for an app and workspace. Returns the buildId you need to start a process via REST.

> [!TIP]
>
> Looking for end-to-end guidance on calling FlowX from your own app? See [Consuming FlowX from external apps](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/consuming-flowx-from-external-apps.md).

## Base URL

* Always prepend the endpoint with the correct Base URL.
* For different environments (like staging or production), switch the base URL accordingly.

> [!NOTE]
>
> This endpoint is only accessible via the admin environment. Ensure that you are using the correct admin base URL when making requests.

## Authorization

**Authorization** `string` *required*

Bearer authentication header of the form Bearer `<token>`, where `<token>` is your auth token.

## Request headers

**Authorization** `string` *required*

Bearer token required for authentication. Format: `Bearer <token>`.

**Accept** `string`

Specifies the media types that are acceptable for the response. Defaults to accepting JSON and plain text responses.

**Accept-Encoding** `string`

Indicates supported content encoding algorithms for the response.

**Accept-Language** `string`

Specifies language preferences for the response.

## Path Parameters

> [!NOTE]
>
> **Need help finding the Application ID or Workspace ID?** See the [Finding Identifiers and Parameters](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/finding-identifiers-and-parameters.md) guide for detailed instructions on where to locate these values in FlowX Designer.

**workspaceId** `string` *required*

The unique identifier of the workspace that contains the application. This parameter is used to search for the appId within the specified workspace. This value is populated by the Configurator in the container app and varies across different environments (e.g., production, development, UAT).

**appId** `string` *required*

The unique identifier of the application whose build information is being retrieved.

```bash theme={"dark"}
curl --request GET \
  --url https://admin.devmain.flowxai.dev/rtm/api/runtime/wks/{workspaceId}/app/{appId}/build/info \
  --header "Authorization: Bearer <token>" \
  --header "Flowx-Platform: web"
```

## Response Fields

**workspaceId** `string`

The unique identifier of the workspace that contains the application.

**buildId** `string`

The unique identifier of the build entity.

**applicationId** `string`

The ID of the application associated with the build.

**buildSettings** `object`

Contains configuration settings related to the build.

**Properties**

**applicationVersionId** `string`

The version ID of the application associated with the build.

**platforms** `string`

Indicates the supported platforms for the build (e.g., `OMNICHANNEL`).

**themeId** `string`

The ID of the theme applied to the build.

**dateDisplayFormat** `object`

Defines the format used for displaying dates.

**Properties**

**format** `string`

Specifies the date format style (e.g., `short`).

**numberDisplayFormat** `object`

Configuration for displaying numerical values, including decimal precision.

**Properties**

**minDecimals** `integer`

The minimum number of decimal places to display in numerical values.

**maxDecimals** `integer`

The maximum number of decimal places to display in numerical values.

**currencyDisplayFormat** `object`

Defines the format used for displaying currency.

**Properties**

**format** `string`

Specifies the format for displaying currency (e.g., `isoCode`).

**defaultLanguageCode** `string`

The default language code for the build (e.g., `en` for English).

```json Success theme={"dark"}
{
  "workspaceId": "12341234-1234-1234-1234123412341234",
  "buildId": "11111111-1111-1111-1111-111111111111",
  "applicationId": "4ffeeb22-e84a-400f-9e07-b305ab0b4241",
  "buildSettings": {
    "applicationVersionId": "99f24e3f-e331-48ad-a503-2cc1cee5fb95",
    "platforms": "OMNICHANNEL",
    "themeId": "12345678-1234-1234-1234-123456789012",
    "dateDisplayFormat": {
      "format": "short"
    },
    "numberDisplayFormat": {
      "minDecimals": 1,
      "maxDecimals": 2
    },
    "currencyDisplayFormat": {
      "format": "isoCode"
    },
    "defaultLanguageCode": "en"
  }
}
```

## Response Headers

**Access-Control-Allow-Credentials** `boolean`

Indicates whether the response can be exposed when credentials are present. Example: `true`.

**Access-Control-Allow-Headers** `string`

Lists the allowed headers in the actual request.

**Access-Control-Allow-Methods** `string`

Specifies the allowed HTTP methods.

**Access-Control-Allow-Origin** `string`

Indicates the allowed origin for cross-origin requests.

**Content-Encoding** `string`

Specifies the encoding used to compress the response.

**Content-Type** `string`

Indicates the media type of the response content.

**Strict-Transport-Security** `string`

Enforces secure (HTTPS) connections to the server.

**Vary** `string`

Specifies that the response may vary based on the `Accept-Encoding` request header.

**X-Content-Type-Options** `string`

Prevents the browser from MIME-sniffing a response away from the declared `Content-Type`.

**X-XSS-Protection** `string`

Controls the cross-site scripting (XSS) filter. Example: `0` (disabled).


## Related topics

- [Get build info by process instance](https://docs.flowx.ai/6.x/docs/api/start-process/build-info-by-process-instance.md)
- [Get build info by UI flow session](https://docs.flowx.ai/6.x/docs/api/start-process/build-info-by-ui-flow-session.md)
- [Consuming FlowX from external apps](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/consuming-flowx-from-external-apps.md)
- [Anonymous runtime access](https://docs.flowx.ai/6.x/docs/platform-deep-dive/user-roles-management/anonymous-runtime-access.md)
- [FlowX.AI 5.6.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.6.0-march-2026/v5.6.0-march-2026.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.