Introduction

You can interact with our GraphQL API / REST API by sending HTTP requests in any language. Before using it, you need to create an API Key in the Dashboard (opens in a new tab).

Creating API Key

In Dashboard (opens in a new tab), click on Settings in the dropdown menu on the right, then click on Developer in the sidebar on the left to see the developer options.

Find the API Key area, and click the Generate New Token button to generate an API Key.

Click the View button to view the API Key.

Click the Copy button to copy the API Key.

Using API Key

Authentication

Zeabur API can optionally use the API Key for authentication. Ensure you have generated a valid API Key.

All API requests should include your API Key in the Authorization HTTP header as shown below:

Authorization: Bearer ZEABUR_API_KEY

Sending a REST API Request

You can use any HTTP client library or within your application to send requests. Here is an example:

You can paste the following command into the terminal to run your first REST API request. Be sure to replace $ZEABUR_API_KEY with your API Key:

curl https://gateway.zeabur.com/api/v1/users/me \
  -H "Authorization: Bearer $ZEABUR_API_KEY" \
  -H "Content-Type: application/json" \

This queries the current user's information. You should receive a response similar to the following:

{
    "_id": "64ffffffffffffffffff",
    "name": "Zeabur Zebra",
    "email": "zebra@zeabur.com",
    "username": "zeabra",
    "language": "en-US",
    "githubID": 5000000,
    "avatarUrl": "https://avatars.githubusercontent.com/u/5000000?v=4",
    "createdAt": "2023-08-31T08:14:08.873Z",
    "bannedAt": null,
    "bannedReason": null,
    "emailPreference": {
        "buildFailed": true,
        "deploymentCrashed": true
    },
    "agreedAt": "2023-08-31T08:14:17.028Z",
    "referralCode": "zeabra",
    "discordID": "7000000000000000000",
    "customerID": "cus_xxxxxxxxxxxxxx"
}

Now that you have successfully authenticated with the API Key, you can use the API Key to access other REST APIs.

The access method for the GrapQL API is the same as above, but the request method is different. You can try the GraphQL API in the GraphQL Playground (opens in a new tab).