Get Auth Context

Overview

Returns the authenticated user’s profile, their associated business (workspace), whether onboarding is complete, and their role within the business. Use this endpoint to bootstrap your application after login.

Request

Method: GET URL: /api/v1/auth/me

Headers

Header	Value
Authorization	Bearer

No request body is required.

Response

object

The authenticated user’s profile.

Show user fields

string (UUID)

Unique identifier for the user.

string

The user’s email address.

string

The user’s full name.

boolean

Whether the user’s email has been verified.

boolean

Whether this account was created via Google OAuth.

string | null

URL of the user’s avatar image, or null if not set.

object | null

The business (workspace) associated with this user. null if onboarding is not complete.

Show business fields

string (UUID)

Unique identifier for the business.

string

The business name.

string | null

The business website URL.

string | null

The business’s support goal.

string | null

The business’s industry.

string | null

The team size descriptor (e.g. "1-10").

string (ISO 8601)

Timestamp when the business was created.

boolean

true if the user has completed onboarding (i.e. a business record exists).

string | null

The user’s role within the business. One of "owner", "admin", "agent", or null if no business is associated.

Example

curl https://api.pingback.live/api/v1/auth/me \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch('https://api.pingback.live/api/v1/auth/me', {
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});
const data = await response.json();

Response example

{
  "user": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "[email protected]",
    "full_name": "Jane Smith",
    "is_verified": true,
    "is_google_account": false,
    "avatar_url": null
  },
  "business": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Acme Support",
    "website": "https://acme.com",
    "goal": "Reduce response time",
    "industry": "SaaS",
    "team_size": "1-10",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "onboarding_complete": true,
  "team_role": "owner"
}

Errors

Status	Meaning
401	Unauthorized — missing or invalid Bearer token

Authentication

Conversations

Channels & Widget

Team

Knowledge Base

Analytics

Overview

Request

Headers

Response

Example

Response example

Errors

​Overview

​Request

​Headers

​Response

​Example

​Response example

​Errors

Overview

Request

Headers

Response

Example

Response example

Errors