Skip to content

`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.

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
api_url

The API base to send this organization’s requests to: its region’s. null when this deployment does not know that region’s address.

string | null
name
required
string
org
required
string
plan
required
string
region
required

Where the organization’s data lives, eu or us (DAWG-159).

string
role
required
string
Allowed values: viewer operator admin owner
slug
required
string
name
string | null
timezone
required
string

Example

{
"memberships": [
{
"role": "viewer"
}
]
}

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}