---
title: "Create/store the metadata for a previously uploaded mobile app file"
method: POST
path: "/mobile/apps/files"
tags: ["MobileAppFile"]
---

# Create/store the metadata for a previously uploaded mobile app file

`POST /mobile/apps/files`

## Request body

- MobileAppFile — Represents a mobile app file build file to be used for training or executing mobile tests
  - `branch` string — The branch from which this mobile app file was built
  - `content_type` string — The content type of the mobile app file file
  - `crc32c_hex` string — The CRC32C checksum for this mobile app file, encoded as a hex string
  - `created_by_id` string — The ID of the user who created this mobile app file
  - `created_time` integer — The time at which this mobile app file was created
  - `download_url` string — Signed URL used to download this mobile app file
  - `extension` string — The file extension, defined as all characters of the name following (but not including) the last "." , e.g. "apk" or "app" The specific extension is important in the case of mobile because the emulators/simulators/devices validate that the app file is the expected type by inspecting the extension. Some platforms, like ios, use multiple extensions, so it is not always possible to infer the extension from the platform.
  - `id` string — The unique ID for this mobile app file
  - `labels` string[] — Labels associated with this mobile app file
  - `last_updated_by_id` string — The ID of the user who last updated this mobile app file
  - `last_updated_time` integer — The time at which this mobile app file was last updated
  - `name` string — The name of the mobile app file file, e.g. mabl-v1.2.3.apk
  - `platform` 'android' | 'ios' — The mobile platform associated with this object
  - `size` integer — The size of the mobile app file file in bytes
  - `uri` string — The URI of the mobile app file indicating its path in cloud storage
  - `version` string — The version of the mobile app file, e.g. 1.4.5 or a git hash
  - `workspace_id` string — The ID of the workspace that this mobile app file belongs to

## Response `201`

The complete mobile app file that was created

- MobileAppFile — Represents a mobile app file build file to be used for training or executing mobile tests
  - `branch` string — The branch from which this mobile app file was built
  - `content_type` string — The content type of the mobile app file file
  - `crc32c_hex` string — The CRC32C checksum for this mobile app file, encoded as a hex string
  - `created_by_id` string — The ID of the user who created this mobile app file
  - `created_time` integer — The time at which this mobile app file was created
  - `download_url` string — Signed URL used to download this mobile app file
  - `extension` string — The file extension, defined as all characters of the name following (but not including) the last "." , e.g. "apk" or "app" The specific extension is important in the case of mobile because the emulators/simulators/devices validate that the app file is the expected type by inspecting the extension. Some platforms, like ios, use multiple extensions, so it is not always possible to infer the extension from the platform.
  - `id` string — The unique ID for this mobile app file
  - `labels` string[] — Labels associated with this mobile app file
  - `last_updated_by_id` string — The ID of the user who last updated this mobile app file
  - `last_updated_time` integer — The time at which this mobile app file was last updated
  - `name` string — The name of the mobile app file file, e.g. mabl-v1.2.3.apk
  - `platform` 'android' | 'ios' — The mobile platform associated with this object
  - `size` integer — The size of the mobile app file file in bytes
  - `uri` string — The URI of the mobile app file indicating its path in cloud storage
  - `version` string — The version of the mobile app file, e.g. 1.4.5 or a git hash
  - `workspace_id` string — The ID of the workspace that this mobile app file belongs to

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Entity not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)