Request

This request uses POST method, which is used to register a native mobile application in Katalon TestCloud, associating it with a specific organization. Registration enables the application to be managed and utilized within the organization's testing environment.

Enter the following information:

In the Authorization header, replace YOUR_JWT with our JSON Web Token (JWT). For more information on how to obtain one, see JSON Web Token Authentication.
x-project-id: Your Project ID

In the request body, provide the following required parameters:

storagePath: The unique identifier for the application's storage location within Katalon's system. This is typically a UUID provided upon uploading the application.
fileName: The name of the application file, including its extension (e.g., app.apk for Android or app.ipa for iOS).
organizationId: The numeric ID of the organization to which the application should be associated.

For example:

curl --location 'https://{{subdomain}}.katalon.com/v2/tc/ees/apps' \
--header 'authorization: Bearer [YOUR_JWT]' \
--header 'Content-Type: application/json' \
--header 'x-project-id: YOUR_PROJECT_ID'
--data '{
    "storagePath": "56698de6-23a2-414d-85dd-2930dd45c1c4",
    "fileName": "app.apk",
    "organizationId": 112
}'

Optionally, use the following query commands to filter the request data:

pageToken to indicate the page number for pagination.
size to specify the number of records to return.
sort to sort the results by ascending or descending order.

Response

The response returns detailed information about a specific mobile app, including metadata, upload status, size, and more.

See the following example:

{
    "appId": "12345",
    "appName": "app.apk",
    "organizationId": 112,
    "status": "registered",
    "createdDate": "2025-02-11T15:12:21Z"
}

Refer to the following table about the response body properties:

Property	Type	Description
`appId`	Integer	The app ID.
`appName`	String	The app name.
`organizationId`	Integer	The organization ID.
`status`	String	Status (e.g. `registered`).
`createdDate`	Integer	Date, time when the app was created.

Try it!

Enter the required (and optional, if applicable) fields below.
Select the language in Language.
Enter your user name or API credentials.
Review your API call and click Try it!

200Create successfully

400Bad request

403Unauthorized

500Internal server error