• Tools
  • Tools
loading...
No Results
Home > Documentation

List Organization App Library Applications

Tool Name: Not defined in the current tool contract

Risk Level: Read

Execution Mode: Synchronous

Category: Organization App Library

Quick Start (Copy and Use)

Summary: Browse Organization App Library applications with simple platform, keyword, sorting, and pagination controls.

Prerequisites: A configured AirDroid Business credential. No application or release ID is required.

Success Criteria: StatusCode is 200 and ErrorMessage is empty. Applications and Pagination then contain the current page; an empty Applications array is a valid result.

What to Do Next: Use latest_release.release_id from an application that has latest_release to inspect that release with List Organization App Library Distribution Status.

Minimal Request Example:

{
  "PageIndex": 1,
  "PageSize": 20
}

Minimal Response Example:

{
  "Applications": [],
  "Pagination": {
    "total": 0,
    "page_size": 20,
    "page_index": 1,
    "last_page": 1
  },
  "Hint": "",
  "Retryable": false,
  "OriginalStatusCode": 200,
  "StatusCode": 200,
  "ErrorMessage": ""
}

Recipes (Common Recipes)

Recipe 1: Browse One Platform

When to use: You need a simple catalog view of applications for one platform.

{
  "Platform": "Android",
  "PageIndex": 1,
  "PageSize": 20
}

Recipe 2: Find by Name or Package ID Text

When to use: A substring is sufficient and a structured filter is not needed.

{
  "Platform": "All",
  "Keyword": "agent",
  "SortBy": "updated_at",
  "SortOrder": "desc",
  "PageIndex": 1,
  "PageSize": 20
}

Recipe 3: Read the Next Page

When to use: A successful response has Pagination.page_index < Pagination.last_page.

{
  "Platform": "All",
  "Keyword": "",
  "SortBy": "name",
  "SortOrder": "asc",
  "PageIndex": 2,
  "PageSize": 100
}

1. Overview

1.1 Description

Lists the Organization App Library using only the simple Platform and Keyword controls, plus sorting and pagination.

1.2 When to Use

  • Browse a platform-specific or complete application catalog.
  • Find an application by a name or package ID substring.
  • Obtain an application's latest_release.release_id for release-specific work.

1.3 Execution Mode and Response

This is a synchronous, read-only operation. It is idempotent. A successful page can contain zero applications; that is not an error.

1.4 Prerequisites

Condition Description
Credential Configure a valid AirDroid Business OAuth2 credential.
Valid page values PageIndex and PageSize are positive whole numbers; PageSize is at most 100.

1.5 Prerequisite Tools

No other tool is required.

1.6 Similar Tools

Use Search Organization App Library Applications when the simple Platform and Keyword controls are insufficient and structured Filter conditions are needed. Use List Organization App Library Distribution Status only after obtaining a specific latest_release.release_id and needing per-device rollout information.

2. Inputs

2.1 Parameter List

Parameter Type Required Default Description
Platform string No All Platform catalog control.
Keyword string No "" Case-insensitive application-name or package-ID substring.
SortBy string No updated_at Sort key.
SortOrder string No desc Sort direction.
PageIndex number No 1 1-based page index.
PageSize number No 20 Items per page, from 1 through 100.

2.2 Parameter Details

`Platform`

Allowed values are All, Android, Windows, and Web. Values are accepted case-insensitively and returned in the canonical capitalization. Use All to include every platform.

`Keyword`

Provide a string of at most 255 characters. It matches any part of the application name or package ID without regard to case. Leave it empty to include all applications. It is a simple text control, not a structured filter.

`SortBy` and `SortOrder`

SortBy is name or updated_at. SortOrder is asc or desc. name sorts by application name; updated_at sorts by last application update time.

`PageIndex` and `PageSize`

The DSL types are number. At runtime, each value may also be a digit-only string, with surrounding whitespace trimmed, and is converted to an integer. Use a positive whole number such as 1 or a compatible numeric string such as "1"; decimals, exponent notation, non-numeric text, zero, and negative values are invalid. PageIndex defaults to 1 and PageSize defaults to 20 when omitted or blank. PageSize is limited to 1 through 100; keep it small when only a few results are needed.

2.3 Parameter Combination Logic

Platform, Keyword, sorting, and pagination apply to the same browse request. For the next page, retain the same controls and increase PageIndex only while Pagination.page_index < Pagination.last_page.

3. Outputs

3.1 Response Examples

The Quick Start response is a successful empty page.

Invalid page size:

{
  "Applications": [],
  "Pagination": {},
  "Hint": "Use PageSize between 1 and 100, then retry.",
  "Retryable": false,
  "OriginalStatusCode": 0,
  "StatusCode": -1,
  "ErrorMessage": "PageSize 101 exceeds the maximum (100)."
}

3.2 Field Descriptions

Field Type Description
Applications object-array Current page of application-library records.
Applications[].store_id integer Application-library identifier.
Applications[].name string Application name.
Applications[].package_id string Platform-specific application identifier.
Applications[].platform string Android, Windows, or Web.
Applications[].remark string Application remark.
Applications[].updated_at string/null UTC time in YYYY-MM-DD HH:mm:ss, or null.
Applications[].latest_release object/null Most recently updated release, regardless of release status, or null when no release exists.
Applications[].latest_release.release_id integer Release identifier for release-specific workflows.
Applications[].latest_release.version string Release version.
Applications[].latest_release.status string Current release status.
Applications[].latest_release.updated_at string/null UTC release update time or null.
Pagination object total, page_size, page_index, and last_page for this result set.
Hint string Recommended next action after a failure; empty on success.
Retryable bool Whether the same request may be attempted again after a failure.
OriginalStatusCode number Upstream HTTP status; 0 means no response was received.
StatusCode number Tool status.
ErrorMessage string Empty on success; otherwise the failure reason.

3.3 Status and Enum Values

Field Values Meaning
Applications[].platform Android, Windows, Web Application platform.
Applications[].latest_release.status The version has been deleted, Paused Rollout, Ready to rollout, Releasing, Rolled out to all devices, Scheduled Release, Unknown Release status.
StatusCode -1 Local parameter validation failed.
StatusCode 200 Request completed; ErrorMessage must still be empty for success.
StatusCode 500 Upstream, system, or network failure.

3.4 Pagination

Pagination.page_index and Pagination.last_page are 1-based. When page_index < last_page, request the next page with PageIndex + 1. PageSize defaults to 20 and cannot exceed 100.

4. Examples

4.1 Basic Example: Browse All Applications

{
  "Platform": "All",
  "Keyword": "",
  "SortBy": "updated_at",
  "SortOrder": "desc",
  "PageIndex": 1,
  "PageSize": 20
}

4.2 Advanced Example: Alphabetical Platform Browse

{
  "Platform": "Windows",
  "Keyword": "",
  "SortBy": "name",
  "SortOrder": "asc",
  "PageIndex": 1,
  "PageSize": 100
}

4.3 Error Example: Unsupported Platform

{
  "Platform": "Linux"
}

This returns StatusCode -1, ErrorMessage Platform is invalid., and a hint to use All, Android, Windows, or Web.

5. Error Handling

Condition Visible result Action
Missing credential StatusCode: -1, ErrorMessage: access_token is required. Configure a valid credential.
Invalid platform, keyword, sort, or page value StatusCode: -1 Correct the value using Hint; do not retry unchanged input.
HTTP 429 StatusCode: 500, Retryable: true Wait 10-30 seconds, then retry once.
HTTP 401 or 403 StatusCode: 500 Refresh authorization or request the required permission.
Other transient upstream HTTP failure StatusCode: 500; Retryable is true only for HTTP 500, 502, 503, or 504 Retry only when Retryable is true.
Upstream business error StatusCode: 200, non-empty ErrorMessage Treat it as a failure; follow Hint and do not rely on StatusCode alone.

6. Best Practices

6.1 Performance

Use Keyword and Platform before paging through a large catalog. Request only the page size needed for the current decision.

6.2 Safety

This is read-only and does not change the Organization App Library.

6.3 Idempotency

Idempotent. Repeating the same read request does not change application-library state.

7. Related Tools

Tool Use
Search Organization App Library Applications Use structured filtering instead of the simple list controls.
List Organization App Library Distribution Status Inspect per-device distribution for a selected latest_release.release_id.
Retry Organization App Library Distribution Retry eligible failed deliveries for a selected release after status inspection.

8. Tool Chains

8.1 Browse a Release and Inspect Its Rollout

List Organization App Library Applications -> List Organization App Library Distribution Status
  1. Browse applications and select an item whose latest_release is not null.
  2. Pass latest_release.release_id as ReleaseId to List Organization App Library Distribution Status.
  3. Use Counts and Records to inspect the rollout; do not treat the list page itself as rollout status.
Updated on: Aug 5, 2026
Was This Page Helpful?
Discussion

Leave a Reply. Cancel reply

Your email address will not be published. Required fields are marked*

Product-related questions?Contact Our Support Team to Get a Quick Solution>
On this page
  • Quick Start (Copy and Use)
  • Recipes (Common Recipes)
    • Recipe 1: Browse One Platform
    • Recipe 2: Find by Name or Package ID Text
    • Recipe 3: Read the Next Page
  • 1. Overview
    • 1.1 Description
    • 1.2 When to Use
    • 1.3 Execution Mode and Response
    • 1.4 Prerequisites
    • 1.5 Prerequisite Tools
    • 1.6 Similar Tools
  • 2. Inputs
    • 2.1 Parameter List
    • 2.2 Parameter Details
    • 2.3 Parameter Combination Logic
  • 3. Outputs
    • 3.1 Response Examples
    • 3.2 Field Descriptions
    • 3.3 Status and Enum Values
    • 3.4 Pagination
  • 4. Examples
    • 4.1 Basic Example: Browse All Applications
    • 4.2 Advanced Example: Alphabetical Platform Browse
    • 4.3 Error Example: Unsupported Platform
  • 5. Error Handling
  • 6. Best Practices
    • 6.1 Performance
    • 6.2 Safety
    • 6.3 Idempotency
  • 7. Related Tools
  • 8. Tool Chains
    • 8.1 Browse a Release and Inspect Its Rollout
loading...
No Results