Get current user | Astronomer Documentation

curl https://api.astronomer.io/v1/users/self \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "avatarUrl": "https://cdn.astronomer.io/avatars/janedoe.png",
  "createdAt": "2023-11-20T14:22:00Z",
  "fullName": "Jane Doe",
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "status": "ACTIVE",
  "updatedAt": "2024-04-10T08:15:30Z",
  "username": "janedoe",
  "featureFlags": [
    {
      "key": "betaAccess",
      "value": true
    },
    {
      "key": "darkMode",
      "value": false
    }
  ],
  "invites": [
    {
      "expiresAt": "2024-07-01T00:00:00Z",
      "inviteId": "inv-1234567890abcdef",
      "organizationId": "org-0987654321fedcba"
    }
  ],
  "isIdpManaged": false,
  "organizationId": "org-0987654321fedcba",
  "roles": [
    {
      "role": "Admin",
      "scope": {
        "entityId": "org-0987654321fedcba",
        "type": "ORGANIZATION",
        "dagTag": null,
        "deploymentId": null
      }
    },
    {
      "role": "Viewer",
      "scope": {
        "entityId": "ws-5678efgh1234abcd",
        "type": "WORKSPACE",
        "dagTag": "data-pipelines",
        "deploymentId": "dep-1234abcd5678efgh"
      }
    }
  ]
}

Get the authenticated user's profile and roles.

curl https://api.astronomer.io/v1/users/self \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "avatarUrl": "https://cdn.astronomer.io/avatars/janedoe.png",
  "createdAt": "2023-11-20T14:22:00Z",
  "fullName": "Jane Doe",
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "status": "ACTIVE",
  "updatedAt": "2024-04-10T08:15:30Z",
  "username": "janedoe",
  "featureFlags": [
    {
      "key": "betaAccess",
      "value": true
    },
    {
      "key": "darkMode",
      "value": false
    }
  ],
  "invites": [
    {
      "expiresAt": "2024-07-01T00:00:00Z",
      "inviteId": "inv-1234567890abcdef",
      "organizationId": "org-0987654321fedcba"
    }
  ],
  "isIdpManaged": false,
  "organizationId": "org-0987654321fedcba",
  "roles": [
    {
      "role": "Admin",
      "scope": {
        "entityId": "org-0987654321fedcba",
        "type": "ORGANIZATION",
        "dagTag": null,
        "deploymentId": null
      }
    },
    {
      "role": "Viewer",
      "scope": {
        "entityId": "ws-5678efgh1234abcd",
        "type": "WORKSPACE",
        "dagTag": "data-pipelines",
        "deploymentId": "dep-1234abcd5678efgh"
      }
    }
  ]
}

Get the authenticated user's profile and roles.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

createIfNotExistbooleanOptional

Create the user if they don't already exist.

Response

avatarUrlstring

The URL for the user's profile image.

createdAtstringformat: "date-time"

The time when the user was created.

fullNamestring

The user's full name.

idstring

The user's ID.

statusenum

The user's status.

Allowed values:

updatedAtstringformat: "date-time"

The time when the user was last updated.

usernamestring

The user's username.

featureFlagslist of objects

The user's feature flags.

inviteslist of objects

The user's pending Organization invites.

isIdpManagedboolean

Whether the user is managed by an identity provider.

organizationIdstring

The user's primary Organization ID.

roleslist of objects

The user's roles across all scopes.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

$	curl https://api.astronomer.io/v1/users/self \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

1	{
2	"avatarUrl": "https://cdn.astronomer.io/avatars/janedoe.png",
3	"createdAt": "2023-11-20T14:22:00Z",
4	"fullName": "Jane Doe",
5	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
6	"status": "ACTIVE",
7	"updatedAt": "2024-04-10T08:15:30Z",
8	"username": "janedoe",
9	"featureFlags": [
10	{
11	"key": "betaAccess",
12	"value": true
13	},
14	{
15	"key": "darkMode",
16	"value": false
17	}
18	],
19	"invites": [
20	{
21	"expiresAt": "2024-07-01T00:00:00Z",
22	"inviteId": "inv-1234567890abcdef",
23	"organizationId": "org-0987654321fedcba"
24	}
25	],
26	"isIdpManaged": false,
27	"organizationId": "org-0987654321fedcba",
28	"roles": [
29	{
30	"role": "Admin",
31	"scope": {
32	"entityId": "org-0987654321fedcba",
33	"type": "ORGANIZATION",
34	"dagTag": null,
35	"deploymentId": null
36	}
37	},
38	{
39	"role": "Viewer",
40	"scope": {
41	"entityId": "ws-5678efgh1234abcd",
42	"type": "WORKSPACE",
43	"dagTag": "data-pipelines",
44	"deploymentId": "dep-1234abcd5678efgh"
45	}
46	}
47	]
48	}