# <a id="bitdrift.public.shared.platform.v1.Platform"></a>Platform

**Source definition:** [`src/bitdrift/public/shared/platform/v1/platform.proto#L18-L60`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/shared/platform/v1/platform.proto#L18-L60>)

Represents platforms that workflows and dashboards can target or filter by.

 Use this message to select platforms for workflow configuration or to filter
 requests such as listing workflows. App version information provides
 additional filtering within each platform.

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| apple | <span class="proto-type proto-type-message">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">shared</i><i class="proto-type-dot">.</i><i class="proto-type-part">platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">Platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">Apple</i>](#bitdrift.public.shared.platform.v1.Platform.Apple "bitdrift.public.shared.platform.v1.Platform.Apple")</span><span class="proto-field-annotation">only one of <em>apple</em>, or <em>android</em> can be set</span> | Targets Apple platforms. |
| android | <span class="proto-type proto-type-message">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">shared</i><i class="proto-type-dot">.</i><i class="proto-type-part">platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">Platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">Android</i>](#bitdrift.public.shared.platform.v1.Platform.Android "bitdrift.public.shared.platform.v1.Platform.Android")</span><span class="proto-field-annotation">only one of <em>android</em>, or <em>apple</em> can be set</span> | Targets Android platforms. |

</section>
<p class="h4">Example</p>
```json
{
  "apple": {
    "apps": [
      {
        "app_id": "com.example.app"
      }
    ]
  }
}
```

# <a id="bitdrift.public.shared.platform.v1.Platform.AppVersions"></a>Platform.AppVersions

**Source definition:** [`src/bitdrift/public/shared/platform/v1/platform.proto#L19-L25`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/shared/platform/v1/platform.proto#L19-L25>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| app_id | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">up to 255 chars</em> | The app ID. |
| app_versions | <span class="proto-type proto-type-primitive">array of string</span><br><em class="proto-field-annotation">up to 100 items</em> | The known app versions for a given app ID. |

</section>
<p class="h4">Example</p>
```json
{
  "app_id": "com.example.app",
  "app_versions": [
    "example"
  ]
}
```

# <a id="bitdrift.public.shared.platform.v1.Platform.App"></a>Platform.App

**Source definition:** [`src/bitdrift/public/shared/platform/v1/platform.proto#L29-L40`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/shared/platform/v1/platform.proto#L29-L40>)

Represents app selection criteria within a platform filter.
 Each platform filter can optionally narrow results by app information.

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| app_id | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">up to 255 chars</em><span class="proto-field-annotation">only one of <em>app_id</em>, or <em>app_versions</em> can be set</span> | Filters by app ID only. |
| app_versions | <span class="proto-type proto-type-message">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">shared</i><i class="proto-type-dot">.</i><i class="proto-type-part">platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">Platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">AppVersions</i>](#bitdrift.public.shared.platform.v1.Platform.AppVersions "bitdrift.public.shared.platform.v1.Platform.AppVersions")</span><span class="proto-field-annotation">only one of <em>app_versions</em>, or <em>app_id</em> can be set</span> | Filters by app ID and app versions. |

</section>
<p class="h4">Example</p>
```json
{
  "app_id": "com.example.app"
}
```

# <a id="bitdrift.public.shared.platform.v1.Platform.Apple"></a>Platform.Apple

**Source definition:** [`src/bitdrift/public/shared/platform/v1/platform.proto#L42-L45`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/shared/platform/v1/platform.proto#L42-L45>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| apps | <span class="proto-type proto-type-message">array of [<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">shared</i><i class="proto-type-dot">.</i><i class="proto-type-part">platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">Platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">App</i>](#bitdrift.public.shared.platform.v1.Platform.App "bitdrift.public.shared.platform.v1.Platform.App")</span><br><em class="proto-field-annotation">up to 100 items</em> | App selection criteria for Apple platforms. |

</section>
<p class="h4">Example</p>
```json
{
  "apps": [
    {
      "app_id": "com.example.app"
    }
  ]
}
```

# <a id="bitdrift.public.shared.platform.v1.Platform.Android"></a>Platform.Android

**Source definition:** [`src/bitdrift/public/shared/platform/v1/platform.proto#L47-L50`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/shared/platform/v1/platform.proto#L47-L50>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| apps | <span class="proto-type proto-type-message">array of [<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">shared</i><i class="proto-type-dot">.</i><i class="proto-type-part">platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">Platform</i><i class="proto-type-dot">.</i><i class="proto-type-part">App</i>](#bitdrift.public.shared.platform.v1.Platform.App "bitdrift.public.shared.platform.v1.Platform.App")</span><br><em class="proto-field-annotation">up to 100 items</em> | App selection criteria for Android platforms. |

</section>
<p class="h4">Example</p>
```json
{
  "apps": [
    {
      "app_id": "com.example.app"
    }
  ]
}
```

