API ReferenceView as MarkdownOpenAPI

Moderation

View as Markdown

Moderation is the owner reviewing what other people put on a marketplace or social site: their products, services, programs and mini apps waiting for approval, and their requests for a professional account. An approval goes live and tells its owner.

Endpoints that need a token: the site owner creates it in their admin (Developers > API reference). AI assistants: how to ask the user for one.

10 endpoints.

Update the admin professional account

Approves or rejects a professional account request (approved). Approving it also approves every item of that account still waiting for review. Answers the account, or 404.

Admin token

Needs a site admin token.

Path parameters
accountstringRequired

The admin professional account's account.

Parameters
approvedboolean

The account was approved as professional.

Returns

Returns the ProfessionalAccount object.

Status codes

200 400 401 404 500

PATCH/admin-professional-accounts/:account
curl -X PATCH 'http://www.startup-fair.com/admin-professional-accounts/{account}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "approved": "..." }'
Response
{
  "user": "6543210fedcba98765432100",
  "reviewed": false,
  "approved": false,
  "cover": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "show": {
    "services": false,
    "staff_members": false,
    "blogposts": false,
    "programs": false,
    "products": false,
    "events": false,
    "price_plans": false,
    "posts": false
  }
}

List all admin professional accounts

Professional account requests, a page at a time.

Admin token

Needs a site admin token.

Path parameters
skipstringRequired

How many results to skip - for paging.

Returns

Returns a list of ProfessionalAccount objects.

Status codes

200 401 500

GET/admin-professional-accounts/:skip
curl -X GET 'http://www.startup-fair.com/admin-professional-accounts/{skip}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
[
  {
    "user": "6543210fedcba98765432100",
    "reviewed": false,
    "approved": false,
    "cover": "6543210fedcba98765432100",
    "_id": "6543210fedcba98765432100",
    "updatedAt": "2026-11-04T12:00:00.000Z",
    "createdAt": "2026-11-04T12:00:00.000Z",
    "show": {
      "services": false,
      "staff_members": false,
      "blogposts": false,
      "programs": false,
      "products": false,
      "events": false,
      "price_plans": false,
      "posts": false
    }
  }
]

Retrieve the mini apps review

Mini apps waiting for review.

Admin token

Needs a site admin token.

Status codes

200 401 500

GET/mini-apps-review
curl -X GET 'http://www.startup-fair.com/mini-apps-review?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "header": "example",
  "description": "Text shown on the site.",
  "referer": "example",
  "requiresLogin": true,
  "icon": "6543210fedcba98765432100",
  "previews": [
    {
      "media": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "owner_id": "6543210fedcba98765432100",
  "reviewed": false,
  "approved": false,
  "total_opened": 0,
  "opened_by": [
    "6543210fedcba98765432101"
  ],
  "minimum_age": 1,
  "language": [
    "example"
  ],
  "collection_id": "6543210fedcba98765432100",
  "total_views": 0,
  "views": [
    "6543210fedcba98765432101"
  ],
  "privacy_policy": "example",
  "support_url": "example-item",
  "marketing_url": "example-item",
  "copyright": "example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "data_collection": {
    "contact_info": "example",
    "health_info": "example",
    "payment_info": "example",
    "location_info": "example",
    "other_info": "example",
    "user_info": "example",
    "identifiers_info": "example",
    "usage_data": "example",
    "diagnostics_data": "example"
  }
}

Update a mini apps review

Approves or rejects a mini app (approved). Answers the mini app, or 404.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the mini apps review.

Parameters
approvedstring

The mini apps review's approved.

reviewedstring

The mini apps review's reviewed.

Status codes

200 400 401 404 500

PATCH/mini-apps-review/:id
curl -X PATCH 'http://www.startup-fair.com/mini-apps-review/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "approved": "...", "reviewed": "..." }'
Response
{
  "title": "Example",
  "header": "example",
  "description": "Text shown on the site.",
  "referer": "example",
  "requiresLogin": true,
  "icon": "6543210fedcba98765432100",
  "previews": [
    {
      "media": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "owner_id": "6543210fedcba98765432100",
  "reviewed": false,
  "approved": false,
  "total_opened": 0,
  "opened_by": [
    "6543210fedcba98765432101"
  ],
  "minimum_age": 1,
  "language": [
    "example"
  ],
  "collection_id": "6543210fedcba98765432100",
  "total_views": 0,
  "views": [
    "6543210fedcba98765432101"
  ],
  "privacy_policy": "example",
  "support_url": "example-item",
  "marketing_url": "example-item",
  "copyright": "example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "data_collection": {
    "contact_info": "example",
    "health_info": "example",
    "payment_info": "example",
    "location_info": "example",
    "other_info": "example",
    "user_info": "example",
    "identifiers_info": "example",
    "usage_data": "example",
    "diagnostics_data": "example"
  }
}

Update a products review

Approves or rejects a marketplace product (approved) and tells its owner. An approved product goes live for a month and its owner gets an email and a notification. Answers the product, or 404.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the products review.

Parameters
approvedstring

The products review's approved.

Status codes

200 400 401 404 500

PATCH/products-review/:id
curl -X PATCH 'http://www.startup-fair.com/products-review/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "approved": "..." }'
Response
{
  "name": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "ribbon": "example",
  "striked": "example",
  "price": 49.9,
  "description": "Text shown on the site.",
  "product_informations": [
    {
      "name": "Example",
      "description": "Text shown on the site.",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "product_options": [
    {
      "name": "Example",
      "options": [],
      "informations": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "published": true,
  "available_for_purchase": true,
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "collection_id": "6543210fedcba98765432100",
  "grouping": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "order": 1,
  "owner_id": "6543210fedcba98765432100",
  "connected_account_owner_id": "6543210fedcba98765432100",
  "qty": 1,
  "origin_address": "example",
  "selected": false,
  "custom_1": "example",
  "custom_2": "example",
  "custom_3": "example",
  "about_page": "6543210fedcba98765432100",
  "secondary_cta": {
    "show": false,
    "title": "Example",
    "webUrl": "example",
    "appUrl": "example"
  },
  "attached_priceplans": {
    "name": "Example",
    "priceplans": "example"
  }
}

List all products reviews

Marketplace products waiting for review, a page at a time.

Admin token

Needs a site admin token.

Path parameters
skipstringRequired

How many results to skip - for paging.

Status codes

200 401 500

GET/products-review/:skip
curl -X GET 'http://www.startup-fair.com/products-review/{skip}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "ribbon": "example",
  "striked": "example",
  "price": 49.9,
  "description": "Text shown on the site.",
  "product_informations": [
    {
      "name": "Example",
      "description": "Text shown on the site.",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "product_options": [
    {
      "name": "Example",
      "options": [],
      "informations": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "published": true,
  "available_for_purchase": true,
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "collection_id": "6543210fedcba98765432100",
  "grouping": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "order": 1,
  "owner_id": "6543210fedcba98765432100",
  "connected_account_owner_id": "6543210fedcba98765432100",
  "qty": 1,
  "origin_address": "example",
  "selected": false,
  "custom_1": "example",
  "custom_2": "example",
  "custom_3": "example",
  "about_page": "6543210fedcba98765432100",
  "secondary_cta": {
    "show": false,
    "title": "Example",
    "webUrl": "example",
    "appUrl": "example"
  },
  "attached_priceplans": {
    "name": "Example",
    "priceplans": "example"
  }
}

Update a programs review

Approves or rejects a marketplace program (approved) and tells its owner. An approved program goes live for a month and its owner gets an email and a notification. Answers the program, or 404.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the programs review.

Parameters
approvedstring

The programs review's approved.

Status codes

200 400 401 404 500

PATCH/programs-review/:id
curl -X PATCH 'http://www.startup-fair.com/programs-review/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "approved": "..." }'
Response
{
  "title": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "header": "example",
  "body": "Text shown on the site.",
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "video": "6543210fedcba98765432100",
  "about_page": "6543210fedcba98765432100",
  "weeks": [
    {
      "isCompleted": {},
      "progress": {},
      "title": "Example",
      "days": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "suitability_price_plans": [
    "6543210fedcba98765432101"
  ],
  "isSuitable": false,
  "price": 0,
  "collection_id": "6543210fedcba98765432100",
  "topics": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "owner_id": "6543210fedcba98765432100",
  "connected_account_owner_id": "6543210fedcba98765432100",
  "ribbon": "example",
  "striked": "example",
  "isConsistent": false,
  "isAcademic": true,
  "wildcard_url": {},
  "reviewed": false,
  "approved": false,
  "likes": [
    "6543210fedcba98765432101"
  ],
  "popup": {
    "title": "Example",
    "points": "example"
  }
}

List all programs reviews

Marketplace programs waiting for review, a page at a time.

Admin token

Needs a site admin token.

Path parameters
skipstringRequired

How many results to skip - for paging.

Status codes

200 401 500

GET/programs-review/:skip
curl -X GET 'http://www.startup-fair.com/programs-review/{skip}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "header": "example",
  "body": "Text shown on the site.",
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "video": "6543210fedcba98765432100",
  "about_page": "6543210fedcba98765432100",
  "weeks": [
    {
      "isCompleted": {},
      "progress": {},
      "title": "Example",
      "days": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "suitability_price_plans": [
    "6543210fedcba98765432101"
  ],
  "isSuitable": false,
  "price": 0,
  "collection_id": "6543210fedcba98765432100",
  "topics": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "owner_id": "6543210fedcba98765432100",
  "connected_account_owner_id": "6543210fedcba98765432100",
  "ribbon": "example",
  "striked": "example",
  "isConsistent": false,
  "isAcademic": true,
  "wildcard_url": {},
  "reviewed": false,
  "approved": false,
  "likes": [
    "6543210fedcba98765432101"
  ],
  "popup": {
    "title": "Example",
    "points": "example"
  }
}

Update a services review

Approves or rejects a marketplace service (approved) and tells its owner. An approved service goes live for a month and its owner gets an email and a notification. Answers the service, or 404.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the services review.

Parameters
approvedstring

The services review's approved.

Status codes

200 400 401 404 500

PATCH/services-review/:id
curl -X PATCH 'http://www.startup-fair.com/services-review/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "approved": "..." }'
Response
{
  "title": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "header": "example",
  "description": "Text shown on the site.",
  "bookable": true,
  "expirable": false,
  "confirm_bookings": false,
  "show_notes": false,
  "minutes_delete_bookings": 1,
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "collection_id": "6543210fedcba98765432100",
  "price": 49.9,
  "online_payment": false,
  "book_by_date": false,
  "book_date_range": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "end_date": "2026-11-04T12:00:00.000Z",
  "day_offset": 0,
  "is_recurring": false,
  "max_participants": 1,
  "session_duration": 1,
  "time_between_sessions": 0,
  "discount": [
    {
      "days": 1,
      "per_total_price": 49.9,
      "fixed_price": 49.9,
      "per_day": 1,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "monday": {
    "active": false,
    "hours": "example"
  },
  "tuesday": {
    "active": false,
    "hours": "example"
  },
  "wednesday": {
    "active": false,
    "hours": "example"
  },
  "thursday": {
    "active": false,
    "hours": "example"
  },
  "friday": {
    "active": false,
    "hours": "example"
  },
  "saturday": {
    "active": false
  }
}

List all services reviews

Marketplace services waiting for review, a page at a time.

Admin token

Needs a site admin token.

Path parameters
skipstringRequired

How many results to skip - for paging.

Status codes

200 401 500

GET/services-review/:skip
curl -X GET 'http://www.startup-fair.com/services-review/{skip}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "url": "example-item",
  "static_url": "example-item",
  "header": "example",
  "description": "Text shown on the site.",
  "bookable": true,
  "expirable": false,
  "confirm_bookings": false,
  "show_notes": false,
  "minutes_delete_bookings": 1,
  "medias": [
    {
      "media": "6543210fedcba98765432100",
      "gcs_url": "example-item",
      "gcs_480_30_url": "example-item",
      "gcs_720_30_url": "example-item",
      "gcs_1080_30_url": "example-item",
      "duration": 1,
      "vimeo_uri": "example",
      "vimeo_picture": "example",
      "vimeo_url": "example-item",
      "youtube_url": "example-item",
      "youtube_picture": "example",
      "thumbnail": "example",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "collection_id": "6543210fedcba98765432100",
  "price": 49.9,
  "online_payment": false,
  "book_by_date": false,
  "book_date_range": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "end_date": "2026-11-04T12:00:00.000Z",
  "day_offset": 0,
  "is_recurring": false,
  "max_participants": 1,
  "session_duration": 1,
  "time_between_sessions": 0,
  "discount": [
    {
      "days": 1,
      "per_total_price": 49.9,
      "fixed_price": 49.9,
      "per_day": 1,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "monday": {
    "active": false,
    "hours": "example"
  },
  "tuesday": {
    "active": false,
    "hours": "example"
  },
  "wednesday": {
    "active": false,
    "hours": "example"
  },
  "thursday": {
    "active": false,
    "hours": "example"
  },
  "friday": {
    "active": false,
    "hours": "example"
  },
  "saturday": {
    "active": false
  }
}
↑↓ Navigate↵ GoEsc Close