Skip to content

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.

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.

  • 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/telescopes and GET /v1/me/observing-access/observing-grants return 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).