We're excited to be rolling out a public beta of GlassFrog API v5. It's a huge step forward in capabilities: designed to make GlassFrog easy to integrate with modern tools, from spreadsheets and dashboards, and even to AI agents.

The new API v5 is not backward compatible with v3. Existing v3 integrations will keep working, but v5 uses different keys, different addresses for resources, and different response shapes. Migration will have to be done deliberately, but should still be easy.

To try v5, generate a v5 key from your personal page: click your name at the top of the left-hand sidebar, then open the API tab.

Improved (familiar from v3, better in v5) 🔧💪

• Roles — Now the main way to navigate your org. Browse the full role hierarchy and pull rich context about any role.
• People — now called Actors — A unified view of both human members of the organization, and in the future, AI agents working alongside you.
• Assignments — See who fills which role (human or agent).
• Projects — Organized by role, with visibility controls and project hierarchy (parent projects and sub-projects).
• Actions — Next-actions, organized by role.
• Tensions — Surface and track organizational tensions, with a simpler lifecycle.
• Proposals — A full governance lifecycle: draft changes, propose, respond, withdraw.
• Policies & Domains — Read governance artifacts for any role.
• Metrics & Checklist Items — The same role-organized pattern with visibility controls.
• Custom Fields (Premium) — Role-scoped custom data.
• Circle Strategy — Now readable and writable through the API.

Across the board, v5 has stable typed IDs (no more sequential integers), per-user permissions that match what you see in the app, consistent error messages, and cursor-based pagination.

New in v5💫🎊

• 20x higher rate limits for Premium — 500 requests per hour multiplied by the number of users in the organization (up from 25/hour in v3)
• /me — your hub. See your profile, roles, projects, and actions in one call.
• Org tree in one call — Pull your whole organizational hierarchy as a single nested response — great for org charts, dashboards, and giving AI agents a quick map of the company.
• Role context — A single call that bundles everything needed to have context for a role, either for you, or AI agents you may be working with: identity, purpose, accountabilities, domains, policies, skills, notes, projects, and surrounding governance.
• Skills — Create and manage skill documents in your org's library and link them to roles and agents.
• Notes — Per-role knowledge notes with visibility controls.
• Goals, Targets & Progress — Goal tracking with measurable targets and progress updates (Premium).
• Tags — Now a first-class resource for organizing roles.
• Search — Find resources across your organization in one query.
• Interactive API — Docs at https://app.glassfrog.com/api/v5/docs
• Plan-aware access — Premium and add-on features return clear upgrade guidance on restricted plans.

 

Coming Soon🤩

• MCP server — Connect AI tools to GlassFrog with one click.
• Webhooks — Get pushed updates when things change in your org, instead of polling.

This is a beta. Things may break, and we may make changes as we dial it in based on what we learn from real-world use. If anything looks wrong, behaves unexpectedly, or is missing something you need, please tell us — that's how the beta gets better.

Reach us at support@glassfrog.com with bug reports, questions, or requests.