Voznest Forge

Workspace

WorkspaceProjects

Development

DocsAPI ReferenceSDKsEmbed StudioChangelog
  1. Forge
  2. /Docs

Start here

Getting StartedQuickstartPlatform ConceptsEnvironments

Build

ProjectsIdentityAgentsGatewayCapabilitiesPermissions ReferenceInstallationsLive activity

Commands & interactions

CommandsContext-menu CommandsInteractionsComponentsModals (Forms)Activities (Embedded Apps)

Acting in hubs

MessagesEmbedsEmbeds v2 (Blocks)Embeds v3Incoming WebhooksHub Management APIEvent StreamDelivery

Sign in with Voznest

AccessOpenID Connect

API

APIAuthenticationErrorsRate LimitsSecurity

Publish & operate

App Market & ListingTemplates & SandboxObservability & Team Tools

Tools

SDKsExamplesFAQ & TroubleshootingReference

Publish & operate

App Market & Listing

Make the project public, describe it well and see how it's doing.

Public projects appear in the App Market, where any hub manager can add the production agent. Private projects can still be installed with the install link or OAuth.

What a listing shows

ElementSet it in
Name, icon, banner, accent color, short and long description, developer nameIdentity
Category (any — presets are suggestions), up to 8 tagsProject Settings → Listing
Website, support, terms, privacy linksProject Settings → Listing
Commands (names and descriptions)Commands
Requested capabilitiesCapabilities
Hubs, uses in the last 30 days, % answered, average response timeCalculated by Voznest
Verified badgeGranted by Voznest Trust & Safety

Public endpoints

GET/applications/directorySearch public apps (q, category, paging)
GET/applications/categoriesCategories in use, with counts
GET/applications/:id/installWhat the install screen shows
GET/applications/:id/statsHubs, commands, 30-day interactions, response rate and average response time

Getting installed (and staying installed)

  • Ask for the fewest capabilities; sensitive ones (administrator, manage roles/hub) scare people off.
  • Answer fast: the response rate and average latency are public. Use defer for anything slow.
  • Write descriptions for every command, localize them, and keep the list short.
  • Link a privacy policy if you store anything about members.
Listings must follow the platform rules. Trust & Safety can unlist or suspend a project, disable its webhooks or agents, and every action is recorded.
PreviousSecurityNext Templates & Sandbox