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

Start here

Getting Started

From an empty workspace to an agent answering a command.

The Forge is where you build on Voznest. You create a project, give it an agent (the identity that lives in hubs), declare commands, and decide what the project may do (capabilities) and who can authorize it (access). Your code runs on your own infrastructure and talks to Voznest over HTTPS and the realtime gateway — Voznest never runs it.

  1. 1Create a projectIn Projects choose New project. You become its Owner.
  2. 2Create an agentOpen Agents and create the Production agent. Its token is shown once — store it in your secret manager or a local .env.
  3. 3Add a commandIn Commands, drag in a new command, add parameters, and publish. Or declare it in code with the SDK.
  4. 4Run your codeDownload the SDK, set VOZNEST_BOT_TOKEN and VOZNEST_APP_ID, and start it. The agent comes online.
  5. 5Install itFrom Installations or the install link, add it to a hub you manage. Members now see your command in the / menu.
Try things in Development first: enable it in Environments, create a development agent, and install it into a test hub. Nothing you do there reaches your production users.

Base URL

text
https://api.voznest.com/api/v1

Every response is JSON. Success looks like { "success": true, "data": … }; failures like { "success": false, "error": { "code": "PERMISSION_DENIED", "message": "…" } }.

Next Quickstart