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

Build

Identity

How the project and its agents look: names, avatars, banners, bios and listing details.

A project has a public face (name, icon, banner, accent color, descriptions, developer name, links) and each agent has a user profile (username, display name, avatar, banner, bio, colors). Members see agents with an APP badge everywhere.

Project identity

PATCH/applications/:idname, description (≤400), longDescription (≤4000), icon, banner, accentColor, developerName, category, tags (≤8), websiteUrl, supportUrl, termsUrl, privacyUrl, activityUrl, public

Images are uploaded first with POST /uploads (multipart, purpose app-icon or banner) and then referenced by id. Icons up to 4 MB (cropped to 512×512); banners up to 10 MB.

Agent profiles

PATCH/developer/projects/:id/agents/:agentId/profileusername, displayName, avatar, banner, bio (≤190), hue, bannerHue — in the portal: Identity
PATCH/applications/:id/botThe primary agent edits its own profile with its token (same fields)

Agent avatars up to 8 MB (512×512), banners up to 10 MB. Names that imitate Voznest staff or official accounts are refused.

Changing the project name or icon also updates the primary agent's display name and avatar.
PreviousProjectsNext Agents