Skip to main content
AgentMark uses an Organization → App → Environment hierarchy.

​
Organizations

Each organization represents a company or team. Organizations own billing, members, and all apps within them.
  • One billing configuration per organization
  • Multiple members with role-based access
  • Multiple apps for different services or teams, each with its own environments

​
Apps

Apps are the primary unit of isolation. Each app has its own prompts, traces, datasets, experiments, API keys, metrics, and environments. You can sync an app to a Git repository (GitHub or GitLab). Common patterns:
  • Per-service: customer-support-agent, search-pipeline, onboarding-flow
  • Per-team: team-alpha, team-platform
For staging/production separation, don’t create separate apps. Create environments inside one app instead: every app starts with a live dev environment, and you create staging and prod alongside it, each with its own runtime, API keys, and environment variables.

​
Setting up

  1. Create an organization once AgentMark provisions your account. Request access to receive an invite.
  2. Create an app from your org’s Apps page by clicking Create App. The modal pre-fills a suggested name you can edit before creating; you can connect a Git repo afterwards from the app card’s settings menu → Link Repository.
  3. Invite members from Settings → Members and assign roles (Owner, Admin, Write, Read).
  4. Connect a Git repo to your app for prompt version control and to mirror its .outerlayer/ context directory into the Dashboard on every push.

​
Related

Users and access control

Roles, permissions, custom roles, and SSO

Billing and usage

Tiers, limits, and feature availability

​
Have questions?

Reach out any time: