Universe Public API

Universe Developer Portal

Welcome to the Universe Developer Portal. You'll find comprehensive guides and documentation to help you start working with Universe as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Basic Usage

Beta

As we harden our types, expect minimal but possibly breaking changes.

The Easy Way!

The simplest way to get started is to use the interactive GraphiQL Explorer. This is a live, working playground where you can construct and execute queries. If you're signed into Universe, your user account will automatically be authenticated.

Endpoint

The current GraphQL API endpoint is https://universe.com/graphql/beta. All requests must be HTTP POST requests with application/json encoded bodies.

Authentication

GraphQL requests can be authorization using an API Access Token with the GraphQL scope enabled. Pass the token in your GraphQL request using the Authorization HTTP header with a value Bearer <token>.

cURL Example With Authorization

curl https://www.universe.com/graphql/beta \
  -H "Authorization: Bearer $token" \
  -H "Content-Type: application/json" \
  -d '{ "query": "{ host(id: \"4f5e06cb2078f9730c000014\") { name } }"}'

response:

{
  "data": {
    "host": {
      "name": "Joshua Kelly"
    }
  }
}

Basic Usage