VoltBuilder API (1.0.0)

Download OpenAPI specification:Download

This is the VoltBuilder API specification. You need to have a Pro account or better to use this API. You can request credentials at https://volt.build/plan/

Authentication

vbapi_auth

The VoltBuilder API uses OAuth 2.0 client credential authentication. A bearer token is granted via the authenticate endpoint. The token is passed in the HTTP Authorization header, as documented in the OAuth 2 specification.

Security Scheme Type OAuth2
clientCredentials OAuth Flow
Token URL: https://api.volt.build/v1/authenticate
Scopes:

    app

    Submit apps for building and check build status

    Get the status of the last submitted build

    This endpoint retrieves the status of the last submitted build as JSON.

    Authorizations:

    Responses

    Request samples

    curl --request GET \
      --url https://api.volt.build/v1/app \
      --header 'authorization: Bearer REPLACE_BEARER_TOKEN'

    Response samples

    Content type
    application/json
    Example
    {}

    Submit a new build

    Authorizations:
    Request Body schema: multipart/form-data
    platform
    required
    string
    Enum: "ios" "android"
    app
    required
    string <binary>

    Responses

    Request samples

    curl --request POST \
      --url https://api.volt.build/v1/app \
      --header 'authorization: Bearer REPLACE_BEARER_TOKEN' \
      --form platform=ios \
      --form 'app=@app.zip;type=application/zip'

    authenticate

    Request access tokens to use the API

    Request an access token using client credentials

    This is an OAuth2 compatible endpoint that allows you to request an access token for the API using your client credentials.

    Request Body schema: application/x-www-form-urlencoded
    grant_type
    required
    string

    must be client_credentials

    client_id
    required
    string <uuid>

    a uuid that represents your client

    client_secret
    required
    string

    a client secret (password) assigned to your client_id

    Responses

    Request samples

    Content type
    application/x-www-form-urlencoded
    grant_type=client_credentials&client_id=a75fe631-6aae-4a75-869c-77efdbaae524&client_secret=JejqCteCsZXQVPhDNPGKJ6QM

    Response samples

    Content type
    application/json
    {
    • "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
    • "token_type": "bearer",
    • "expires_in": 3600
    }