Skip to content
Updawg

`GET /v1/me`.

GET
/v1/me
curl --request GET \
  --url https://api.updawg.net/v1/me

The first call a portal makes, and the one that tells it whether there is a session at all — so an empty memberships is a real answer rather than an error. A person who has signed in and belongs to nothing yet is exactly who the “create an organization” screen is for.

Responses

Section titled “Responses”

200

Section titled “200”

Who is signed in, and the organizations they are in.

Media typeapplication/json
object
csrf_token
required

The token every mutation has to echo in X-Updawg-Csrf.

Returned here as well as at sign-in, so a page that has been reloaded can get one without signing in again. It is safe to put in this body and not in a cookie: a cross-origin page cannot read a response, and a cookie would travel on every request whether it was wanted or not.

string
email
required
string
id
required
string
memberships
required

Organizations this person belongs to, and what they may do in each.

Array<object>
object
name
required
string
org
required
string
plan
required
string
role
required
string
Allowed values: viewer operator admin owner
slug
required
string
name
string | null
timezone
required
string
Example
{
  "memberships": [
    {
      "role": "viewer"
    }
  ]
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}