Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Global Service

The global service does not manage any of your sensitive information other than holding onto the last personal access token you used so that it can make Synadia Cloud API requests on your behalf. We don’t want any personal information and nearly all data stored is just reference keys and aggregate statistics to power our dashboard.

Your catalog contents are never queried, stored, or cached by this service.

The Natster global service is consumed by the natster CLI and nearly every function outlined in the API below can be invoked from the CLI.

All of the following API functions are prefixed with, so the whoami function is actually on

events.putThe payload is a cloud event. If valid, the event is written to the appropriate log
heartbeats.putSubmits a heartbeat so the backend can keep track of which catalogs are online
statsAn empty request to this subject will return global summary stats, such as how many catalogs are online
my.sharesRequests the list of all catalogs known to the caller. This includes catalogs shared by the caller and shared to the caller.
otc.generateGenerates a one-time code that can be claimed by an authenticated web user to perform context binding. These tokens will expire in 5 minutes, by default
otc.claimCalled by the Natster website to associate a valid OAuth ID with the context previously published on the otc.generate subject
whoamiCalled by a valid user to obtain information about who Natster thinks they are. Very useful in troubleshooting.
context.getRetrieves a bound context based on the OAuth ID attempting to log in. Only usable by the Natster.IO site account
catalogs.validatenameUsed by the CLI to vet the names used when creating and sharing catalogs. Rejects names of catalogs that have already been created and shared, for example