MAmachines
Apps

List Apps

Changed on

List all apps with the ability to filter by organization slug.

get/v1/apps

Request

  • Base URL
    https://api.machines.dev
  • URL
    https://api.machines.dev/v1/apps
  • Auth
    HTTP bearer

Query parameters

org_slugstring required

The org slug, or 'personal', to filter apps

app_rolestring

Filter apps by role

limitinteger

The number of apps to fetch (must be between 1 and 5000). Providing a limit enables pagination. Without it, all apps are returned in one response.

cursorstring

Value of next_cursor from the previous page. Requires limit. Later pages only include apps that existed when the first page was requested. Apps created in the seconds before the first page was requested may be missing. Cursors expire 30 minutes after the first page was requested.

Response

OK

next_cursorstring

Pagination cursor for the next page. Absent when no more apps remain. Cursors expire 30 minutes after the first page was requested.

total_appsinteger

The number of apps matching the request, across all pages. When paginating, it is counted once when the first page is requested and not updated afterwards, so it may differ slightly from the number of apps returned: it excludes apps created later and includes apps deleted while paginating. Apps created in the seconds before the first page may also be counted but missing from the pages.

Changes

  • 4a82f51548c8Revision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter limit

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

  • f54480c4ce7fRevision changes
    • info

      endpoint added