Profiles

All requests use a single endpoint: POST /functions/v1/api with resource: "profiles".

Access control

Action	Regular user	Admin
`all`	No	Yes
`list`	No	Yes
`get`	Own profile only	Any profile
`create`	No	Yes
`update`	Own profile only	Any profile
`delete`	Own profile only	Any profile

Admin endpoints require a role starting with internal_ (e.g. internal_admin). Non-admin users attempting admin-only actions receive a 403 Forbidden response.

`role` values

Value	Description
`"standard_user"`	Business owner — can create and manage agents, view leads, and access all standard features
`"consumer"`	End user — can talk to agents and interact with consumer-facing features
`"internal_admin"`	Full platform access — can manage all users, agents, marketplace listings, and system settings

Profile mutations (create, update, delete) are automatically logged to the activities table as user_action events. Update actions include the list of changed fields in the activity metadata.

List all profiles (admin)

Retrieves all profiles with complete joined data including subscriptions, call purchases, and phone subscriptions.

resource

string

required

Must be "profiles"

action

string

required

Must be "all"

data

object

Show properties

limit

number

Results per page. Range: 1-500. Default: 50.

offset

number

Pagination offset. Default: 0.

filters

object

Show properties

searchTerm

string

Search in full_name or email.

role

string

Filter by role (exact match).

teamId

number

Filter by team ID.

hasSubscription

boolean

Filter profiles with active subscriptions.

Response

success

boolean

data

object

Show properties

profiles

object[]

Array of full profile objects with joined relations. See profile object.

count

number

limit

number

offset

number

const response = await ApiService.invoke<{
  profiles: Profile[];
  count: number;
  limit: number;
  offset: number;
}>({
  resource: "profiles",
  action: "all",
  data: {
    limit: 100,
    offset: 0,
    filters: {
      role: "internal_admin",
    },
  },
});

List basic profiles (admin)

Retrieves a paginated list of profiles with basic fields only, optimized for lists and dropdowns.

resource

string

required

Must be "profiles"

action

string

required

Must be "list"

data

object

Show properties

limit

number

Results per page. Range: 1-500. Default: 50.

offset

number

Pagination offset. Default: 0.

filters

object

Show properties

searchTerm

string

Search in full_name or email.

role

string

Filter by role.

teamId

number

Filter by team ID.

Response

success

boolean

data

object

Show properties

profiles

object[]

Show Basic profile fields

string

full_name

string | null

role

string | null

avatar_url

string | null

team_id

number | null

created_at

string

updated_at

string

count

number

limit

number

offset

number

const response = await ApiService.invoke<{
  profiles: Profile[];
  count: number;
}>({
  resource: "profiles",
  action: "list",
  data: {
    limit: 50,
    filters: {
      searchTerm: "john@example.com",
    },
  },
});

Get a profile

Retrieves a single profile with complete details including subscriptions and team data. Users can only access their own profile; admins can access any profile.

resource

string

required

Must be "profiles"

action

string

required

Must be "get"

string

required

The profile ID (user UUID).

Response

success

boolean

data

object

Show properties

profile

object

Full profile object with all joined relations. See profile object.

const { user } = await supabase.auth.getUser();
const response = await ApiService.invoke<{ profile: Profile }>({
  resource: "profiles",
  action: "get",
  id: user.id,
});

const subscriptions = response?.profile?.call_purchases;

Create a profile (admin)

Creates a new user profile. The id must match an existing auth user UUID.

resource

string

required

Must be "profiles"

action

string

required

Must be "create"

data

object

required

Show properties

string

required

Auth user UUID. Must match an existing user in the auth system.

full_name

string

role

string

avatar_url

string

phone_number

string

phone_country_code

string

address_line1

string

address_line2

string

city

string

state_province

string

country

string

country_name

string

postal_code

string

company_name

string

job_title

string

date_of_birth

string

timezone

string

preferred_language

string

billing_currency

string

stripe_id

string

hubspot_id

string

team_id

number

marketplace_creator_bio

string

marketplace_creator_verified

boolean

Response (status 201)

success

boolean

data

object

Show properties

profile

object

The created profile with joined data.

const response = await ApiService.invoke<{ profile: Profile }>(
  {
    resource: "profiles",
    action: "create",
    data: {
      id: "auth-user-uuid-here",
      full_name: "Jane Smith",
      email: "jane@example.com",
      role: "standard_user",
    },
  },
  201
);

Update a profile

Updates an existing profile. Users can only update their own profile; admins can update any profile. This is a partial update — only include the fields you want to change.

resource

string

required

Must be "profiles"

action

string

required

Must be "update"

string

required

The profile ID (user UUID).

data

object

required

Any combination of profile fields. See the create action for the full list of fields (all fields except id are accepted).

Response

success

boolean

data

object

Show properties

profile

object

The updated profile with joined data.

const response = await ApiService.invoke<{ profile: Profile }>({
  resource: "profiles",
  action: "update",
  id: userId,
  data: {
    full_name: "John Doe",
    timezone: "America/New_York",
    company_name: "Acme Corp",
  },
});

Delete a profile

Permanently deletes a profile. Users can only delete their own profile; admins can delete any profile.

resource

string

required

Must be "profiles"

action

string

required

Must be "delete"

string

required

The profile ID (user UUID).

Response

success

boolean

data

object

Show properties

success

boolean

message

string

This permanently deletes the profile record.

const response = await ApiService.invoke<{
  success: boolean;
  message: string;
}>({
  resource: "profiles",
  action: "delete",
  id: "user-uuid",
});

Profile object

The full profile object returned by all, get, create, and update actions.

Core fields

string

User UUID.

full_name

string | null

role

string | null

avatar_url

string | null

Contact information

phone_number

string | null

phone_country_code

string | null

Address

address_line1

string | null

address_line2

string | null

city

string | null

state_province

string | null

country

string | null

country_name

string | null

postal_code

string | null

Company

company_name

string | null

job_title

string | null

Preferences

date_of_birth

string | null

timezone

string | null

preferred_language

string | null

billing_currency

string | null

External IDs

stripe_id

string | null

hubspot_id

string | null

Marketplace

marketplace_creator_bio

string | null

marketplace_creator_verified

boolean | null

Team

team_id

number | null

team

object | null

Show properties

number

name

string

brand

string

owner_id

string

created_at

string

Subscription

subscription

object | null

Show properties

number

status

string | null

price_id

string | null

stripe_id

string | null

quantity

number | null

trial_ends_at

string | null

ends_at

string | null

created_at

string

Call purchases

call_purchases

object[]

Show properties

number

quantity

number | null

status

string | null

stripe_subscription_id

string | null

created_at

string

Phone subscriptions

phone_subscriptions

object[]

Show properties

string

phone_number

string

phone_type

string

status

string

stripe_price_id

string

created_at

string

Timestamps

created_at

string

updated_at

string

Activity logging

Profile mutations are logged to the activities table:

Action	Activity type	Action logged
Create	`user_action`	`profile_created`
Update	`user_action`	`profile_updated` (includes `updated_fields` in metadata)
Delete	`user_action`	`profile_deleted`

Error responses

Status	Code	Description
400	`VALIDATION_ERROR`	Profile ID not provided
401	`UNAUTHORIZED`	Invalid or missing authentication token
403	`FORBIDDEN`	Non-admin accessing admin-only action, or user accessing another user’s profile
404	`NOT_FOUND`	Profile does not exist
500	`INTERNAL_ERROR`	Database operation failed

Overview

Agents

Knowledge

Voice

CRM

Marketplace

Platform

Access control

`role` values

List all profiles (admin)

Response

List basic profiles (admin)

Response

Get a profile

Response

Create a profile (admin)

Response (status 201)

Update a profile

Response

Delete a profile

Response

Profile object

Core fields

Contact information

Address

Company

Preferences

External IDs

Marketplace

Team

Subscription

Call purchases

Phone subscriptions

Timestamps

Activity logging

Error responses

Overview

Agents

Knowledge

Voice

CRM

Marketplace

Platform

​Access control

​role values

​List all profiles (admin)

​Response

​List basic profiles (admin)

​Response

​Get a profile

​Response

​Create a profile (admin)

​Response (status 201)

​Update a profile

​Response

​Delete a profile

​Response

​Profile object

​Core fields

​Contact information

​Address

​Company

​Preferences

​External IDs

​Marketplace

​Team

​Subscription

​Call purchases

​Phone subscriptions

​Timestamps

​Activity logging

​Error responses

Access control

`role` values

List all profiles (admin)

Response

List basic profiles (admin)

Response

Get a profile

Response

Create a profile (admin)

Response (status 201)

Update a profile

Response

Delete a profile

Response

Profile object

Core fields

Contact information

Address

Company

Preferences

External IDs

Marketplace

Team

Subscription

Call purchases

Phone subscriptions

Timestamps

Activity logging

Error responses