Me
The Me API exposes information about the currently authenticated user — things the bearer of the access token can read about themselves. It’s the easiest entry point for any integration: hit /v1/me and check that the token works.
Endpoints at a glance
Section titled “Endpoints at a glance”| Endpoint | What it returns |
|---|---|
GET /v1/me |
The user’s own record (including email) |
GET /v1/me/observing-access/telescopes |
Telescopes the user’s observing grants reach, with their instruments |
GET /v1/me/observing-access/observing-grants |
The observing grants the user holds (filter with telescopeUid) |
GET /v1/me/observing-access/owners |
The entities whose observing accounts fund those grants |
GET /v1/me/observing-access/observation-types |
The observation types the user can submit |
GET /v1/me/organizations-with-roles, /v1/me/organization-roles |
Organizations the user belongs to, and the roles held in each |
GET /v1/me/group-roles |
Group roles the user holds |
GET /v1/me/skynet-roles |
Platform-wide roles (for example admin) |
GET /v1/me/invitations |
Pending invitations addressed to the user’s email |
GET /v1/me/schedule |
Scheduled tasks of every observation the user can view, across telescopes (start/end, up to seven days) |
GET /v1/me/connected-apps |
Third-party OAuth apps the user has authorized (revoke with DELETE /v1/me/connected-apps/{clientId}) |
GET /v1/me/notifications |
The user’s notifications (plus preference and rule endpoints under /v1/me/notification-*) |
Personal API tokens are managed under the user record, not /me: GET/POST /v1/users/{slug}/tokens and DELETE /v1/users/{slug}/tokens/{tokenId} (a token’s id is a UUID; your own tokens only).
/v1/me needs no permission beyond a valid token, and any scoped token may call it — handy for auth bootstrapping.
Common task recipes
Section titled “Common task recipes”- Token sanity check.
GET /v1/me. If it succeeds, the token is valid and you know the user identity. - Discover what you can submit to.
GET /v1/me/observing-access/telescopesandGET /v1/me/observing-access/observing-grantsreturn the telescopes and grants the user can submit observations through — see the curl quickstart. - List your scheduled telescope time.
GET /v1/me/schedule?start=…&end=…(a range of up to seven days).