Appetize Docs
HomeDemoUploadPricing
  • Introduction
  • Platform
    • App Management
      • Uploading Apps
        • Android
        • iOS
      • App Dashboard
      • Running Apps
      • App Permissions
    • Device Sandbox
    • Embedding
    • Sharing
    • Session Inactivity Timeout
    • Query Params Reference
  • Features
    • Devices & OS Versions
    • Network Traffic Monitor
    • Debug Logs
    • UI Automation
    • Proxy
    • Language & Locale
    • Mock Location
    • Deep links
    • Launch Params
    • Media
    • Auto-grant Permissions
    • Custom Branding
    • Custom Launch Pages
    • Advanced Features
      • Android
        • ADB tunnel
        • Hide Password Visibility
      • Reserved Devices
  • Account
    • Invite your team
    • Single Sign-On
      • OpenID Connect
      • SAML
      • Azure Active Directory
      • Google Workspace (GSuite)
    • Reporting
      • Session History
      • Usage Summary
  • Infrastructure
    • Configure Network Access
    • Enterprise Hosting Options
  • JavaScript SDK
    • Configuration
    • Automation
      • Device commands
      • Touch interactions
    • API reference
      • Initialization
      • Client
      • Session
      • Types
        • AdbConnectionInfo
        • AppetizeApp
        • AndroidElementAttributes
        • Coordinates
        • DeviceInfo
        • Element
        • ElementBounds
        • IOSAccessibilityElement
        • IOSElementAttributes
        • NetworkRequest
        • NetworkResponse
        • SessionConfig
        • SwipeMove
        • RecordedAction
        • RecordedSwipeAction
        • RecordedKeypressAction
        • RecordedPosition
        • RecordedTapAction
        • RecordedTouchAction
        • UserInteraction
  • Testing
    • Getting Started
    • Writing Tests
    • Running Tests
    • Test Configuration
    • Continuous Integration
    • Record Tests (experimental)
    • Trace Viewer
    • Web Tests on Mobile Browsers
  • REST API
    • Create new app
    • Update existing app
    • Direct file uploads
    • Delete app
    • List apps
    • Usage summary
    • Devices & OS Versions
      • v1
    • IP Blocks
      • v1
    • Sample code
  • Guides & Samples
    • Impersonation
    • Automate Sign-in Flow
    • Screenshot Automation
    • Unlock Device
    • Validate Analytics Events
    • Lock Your Device to One App
    • Test Accessibility Font Sizes
    • Common testing scenarios
    • Samples Repository
  • Deprecated
    • Cross-document messages
  • Changelog
  • Additional Support
    • Knowledge Base
    • Support Request
Powered by GitBook
On this page
  • Getting Started
  • HTTP Requests
  • HTTP Responses

REST API

Seamlessly integrate Appetize into your CI/CD pipeline by making use of our REST API.

PreviousWeb Tests on Mobile BrowsersNextCreate new app

Last updated 1 month ago

Getting Started

If you are using an Enterprise Private Instance of Appetize, please replace all API calls from api.appetize.io to your custom domain, e.g. v1 - custom.appetize.io, v2 - custom.appetize.io/api/

  1. Get Your API Token All users with admin or developer roles may request an API token after logging in and navigating to .

  2. Use Basic Authentication: When sending requests to the Appetize REST API that requires authentication, use Basic Authentication.

  3. Encode your token + ":" using Base64 encoding.

  4. Attach Token to Requests In your HTTP headers, include an Authorization header with the value "Basic" followed by the encoded token.

See our for an example on how to get started.

HTTP Requests

All HTTP POST Requests must use JSON.

HTTP Responses

All HTTP Responses will be in JSON.

Status code
Details

200

OK - Everything worked as expected.

400

Bad Request - Often missing a required parameter.

401

Unauthorized - No valid API token provided.

404

Not Found - No app found for publicKey specified.

500, 502, 503, 504

Server error - something went wrong on our server.

Organization -> API Token
Sample Code