Marketplace

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

Access control

The list, all, get, categories, and stats actions are publicly accessible. The create, update, and delete actions require internal admin authentication.

The create, update, and delete actions are admin-only operations. Only users with the internal_admin role can perform these actions. Non-admin users will receive a 403 Forbidden response.

`sortBy` values

Value	Description
`"popular"`	Sort by view count (most viewed first)
`"newest"`	Sort by creation date (most recent first) — default
`"rating"`	Sort by rating (highest rated first)
`"clones"`	Sort by clone count (most cloned first)

List genies (slim)

Retrieves a simplified list of marketplace genies optimized for dropdowns and compact listings. Returns only essential fields without nested relations.

resource

string

required

Must be "marketplace"

action

string

required

Must be "list"

data

object

Show properties

limit

number

Items per page. Range: 1-500. Default: 20.

offset

number

Pagination offset. Default: 0.

query

object

Show properties

Response

success

boolean

data

object

Show properties

genies

object[]

Show Slim genie fields

string

slug

string

display_name

string

tagline

string

thumbnail_url

string

rating

number

category_id

string

is_featured

boolean

clone_count

number

count

number

limit

number

offset

number

const response = await ApiService.invoke<{
  genies: MarketplaceGenie[];
  count: number;
}>({
  resource: "marketplace",
  action: "list",
  data: {
    limit: 20,
    query: {
      category: "customer-service",
      sortBy: "popular",
    },
  },
});

List genies (complete)

Retrieves the full marketplace genie listing with all fields and nested relations (category, brand, and creator in admin mode).

resource

string

required

Must be "marketplace"

action

string

required

Must be "all"

data

object

Show properties

limit

number

Items per page. Range: 1-500. Default: 20.

offset

number

Pagination offset. Default: 0.

adminMode

boolean

Admin only. Include non-public genies in results.

query

object

Same query parameters as the list action. Default sort: featured first, then by clones.

Response

success

boolean

data

object

Show properties

genies

object[]

Array of full genie objects. See genie object.

count

number

limit

number

offset

number

const response = await ApiService.invoke<{
  genies: MarketplaceGenie[];
  count: number;
}>({
  resource: "marketplace",
  action: "all",
  data: {
    limit: 50,
    query: {
      search: "sales",
      minRating: "4",
    },
  },
});

Get a genie

Retrieves a specific marketplace genie by slug or ID. Automatically increments the view count and includes related genies from the same category.

resource

string

required

Must be "marketplace"

action

string

required

Must be "get"

string

required

The genie slug (preferred) or UUID.

data

object

Show properties

adminMode

boolean

Admin only. Allow fetching non-public genies.

Response

success

boolean

data

object

All fields from the genie object, plus:

Show additional fields

Genies from the same category.

Show properties

string

slug

string

display_name

string

tagline

string

thumbnail_url

string

rating

number

category_id

string

const response = await ApiService.invoke<MarketplaceGenie>({
  resource: "marketplace",
  action: "get",
  id: "sales-assistant",
});

Create a listing

Creates a new marketplace listing. Automatically marks the agent as a marketplace template and links the listing back to the agent.

Only internal admins can create marketplace listings.

resource

string

required

Must be "marketplace"

action

string

required

Must be "create"

data

object

required

Show properties

agent_id

string

required

ID of the agent to list on the marketplace.

slug

string

required

URL-friendly unique identifier.

display_name

string

required

Public display name.

category_id

string

required

Category ID for the listing.

tagline

string

Short one-liner description.

description

string

Full description.

brand_id

string

Associated brand ID.

is_featured

boolean

Feature on homepage. Default: false.

is_public

boolean

Publish to marketplace. Default: true.

thumbnail_url

string

Preview image URL.

demo_video_url

string

Demo video URL.

metadata

object

Additional metadata (e.g. difficulty, industry).

Response (status 201)

success

boolean

data

object

The created marketplace genie with all fields. See genie object.

const response = await ApiService.invoke<MarketplaceGenie>(
  {
    resource: "marketplace",
    action: "create",
    data: {
      agent_id: "agent-123",
      slug: "sales-assistant",
      display_name: "Sales Assistant",
      category_id: "category-456",
      tagline: "Close more deals with voice AI",
      is_featured: true,
      metadata: { difficulty: "beginner", industry: "sales" },
    },
  },
  201
);

Update a listing

Updates an existing marketplace listing.

Only internal admins can update marketplace listings.

resource

string

required

Must be "marketplace"

action

string

required

Must be "update"

string

required

The listing ID.

data

object

required

Show properties

display_name

string

tagline

string

description

string

category_id

string

brand_id

string

is_featured

boolean

is_public

boolean

thumbnail_url

string

demo_video_url

string

metadata

object

Response

success

boolean

data

object

The updated marketplace genie with all fields.

const response = await ApiService.invoke<MarketplaceGenie>({
  resource: "marketplace",
  action: "update",
  id: "genie-uuid",
  data: {
    display_name: "Updated Sales Assistant",
    is_featured: false,
  },
});

Delete a listing

Permanently deletes a marketplace listing and unlinks the agent from the marketplace.

Only internal admins can delete marketplace listings.

resource

string

required

Must be "marketplace"

action

string

required

Must be "delete"

string

required

The listing ID.

Response

success

boolean

data

object

Show properties

success

boolean

string

The deleted listing ID.

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

Retrieves all marketplace categories ordered by display order. No authentication required.

resource

string

required

Must be "marketplace"

action

string

required

Must be "categories"

Response

success

boolean

data

object

Show properties

Get statistics

Retrieves aggregate statistics about the marketplace. No authentication required.

resource

string

required

Must be "marketplace"

action

string

required

Must be "stats"

Response

success

boolean

data

object

Show properties

total_genies

number

Total number of marketplace genies.

total_views

number

Combined view count across all genies.

total_clones

number

Combined clone count across all genies.

featured_count

number

Number of featured genies.

categories_count

number

Number of categories.

const response = await ApiService.invoke<{
  total_genies: number;
  total_views: number;
  total_clones: number;
  featured_count: number;
  categories_count: number;
}>({
  resource: "marketplace",
  action: "stats",
});

Genie object

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

string

agent_id

string

slug

string

display_name

string

tagline

string

description

string

category_id

string

Error responses

Status	Code	Description
400	`VALIDATION_ERROR`	Missing required parameters
401	`UNAUTHORIZED`	Missing or invalid authentication token
403	`FORBIDDEN`	Non-admin attempting a write operation
404	`NOT_FOUND`	Marketplace genie not found
500	`INTERNAL_ERROR`	Server error

Overview

Agents

Knowledge

Voice

CRM

Platform

Marketplace

Access control

`sortBy` values

List genies (slim)

Response

List genies (complete)

Response

Get a genie

Response

Create a listing

Response (status 201)

Update a listing

Response

Delete a listing

Response

Response

Get statistics

Response

Genie object

Error responses

Overview

Agents

Knowledge

Voice

CRM

Marketplace

Platform

​Access control

​sortBy values

​List genies (slim)

​Response

​List genies (complete)

​Response

​Get a genie

​Response

​Create a listing

​Response (status 201)

​Update a listing

​Response

​Delete a listing

​Response

​List categories

​Response

​Get statistics

​Response

​Genie object

​Error responses

Access control

`sortBy` values

List genies (slim)

Response

List genies (complete)

Response

Get a genie

Response

Create a listing

Response (status 201)

Update a listing

Response

Delete a listing

Response

List categories

Response

Get statistics

Response

Genie object

Error responses