POST /api/v2/agents/createFromTemplatecreates a draft agent from a template at an External App’s owning org unit, or at the org unit a Personal key names, withagents:manage,agents:writeandagents:readthere.POST /api/v2/agents/assignProcedureandunassignProceduregrant and revoke a procedure you can read;assignToolandunassignToolgrant and revoke an active tool. Each needsagents:manageat the agent’s home and leaves an operator’s deny in place.POST /api/v2/agents/replaceExemplarsreplaces a worker agent’s 2 to 5 exemplars withagents:writeat its home.- The Console’s tool grant now refuses an unknown or inactive tool.
- MCP: six new tools in the
agentsgroup, fromforge_create_agent_from_templatetoforge_replace_agent_exemplars.
GET /api/v2/connections/admin/secretreads one managed secret’s metadata (name, lifecycle state, store, version and consumer count) withcredentials:read, never its value or who created it.GET /api/v2/connections/admin/secret/migration-previewpreviews moving it to 1Password withcredentials:manage.GET /api/v2/connections/admin/slack/workspaceslists an org unit’s Slack workspace connections withconnections:manage, never who installed one or Slack’s health error text.POST /api/v2/connections/admin/slack/workspaces/agent-viewturns Agent View on or off for one connection, and records the key as a system actor.GET /api/v2/connections/admin/external-tools/configurationsandGET /api/v2/connections/admin/external-tools/configurationread the external tool configurations withplatform:manage.PATCH /api/v2/connections/admin/external-tools/configuration/updateupdates one, andPOST /api/v2/connections/admin/external-tools/configuration/statussets its status. An answer says whether a service-account key or client secret is set, never its value.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Every route is reachable from MCP throughforge_call_operation, in theconnectionsgroup.
POST /api/v2/workforce/createPerson(andforge_create_person) matches anemailonly against people in the caller’s reach. An email held only by a person seated in a customer organization, or under one, used to answer409 (DUPLICATE_DECISION_REQUIRED), which confirmed that such a person exists. It now creates the person and answers201, exactly as for an unused email.- A repeat with the same email then matches the person just created and answers
409 (DUPLICATE_DECISION_REQUIRED)naming it, andduplicateDecisionworks against that person as before. - The Console’s workforce integrity review reports the two people sharing the email until an admin merges them or keeps them separate. Console person creation is unchanged.
GET /api/v2/email/admin/routeslists the inbound email routes withwebhooks:read. It never names who created a route or the workflow it starts.POST /api/v2/email/admin/routes/deletedeletes a route, and the workflow trigger it owns, withwebhooks:manage.GET /api/v2/email/admin/ingressreads the inbound ingress (its token prefix and status, never the token) withwebhooks:read.POST /api/v2/email/admin/ingress/statuspauses or resumes inbound email withwebhooks:manage.GET /api/v2/email/admin/sendersreads the sending domain, the credential scope and each sender’s From address withwebhooks:read.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Every route is reachable from MCP throughforge_call_operation.
GET /api/v2/org-units/admin/drafts/activeno longer answerscreatedByorlastEditedBy, andGET /api/v2/org-units/admin/snapshotsno longer answerspublishedBy. These held a person’s sign-in id, which the generated admin routes never answer.
POST /api/v2/knowledge/asknow reads theknowledge-apiagent budget and the global budget before it retrieves. When either is frozen by an operator (the global spend freeze included) or exhausted, it answers403 forbiddenwith adecisionIdand calls no model. Before, only the platform kill switch stopped it, and a frozen or spent budget was charged after the answer.- With no budget configured,
askanswers as before. Evaluation runs keep their own refusal, read through the same check.
GET /api/v2/workforce/listWorkersandforge_list_workersleave out every seat of a person with any seat in a customer organization or under one, not only that seat. A person who has one customer seat and one other seat appears on neither, asGET /api/v2/workforce/getPersonalready answered404for them.- The Console’s worker directory is unchanged.
- From forge-mcp 9.0.0,
tools/listoffers the core list by default: 70 tools instead of 568. A call to any other tool is refused with the name of theextendedtoolset and theforge_call_operationoperation that does the same thing. - Turn on the
extendedtoolset to keep every tool:FORGE_MCP_TOOLSETS=extendedfor the stdio server, ortoolsets=extended(query parameter) orX-Forge-Mcp-Toolsets: extended(header) on the hosted endpoint. - New
forge_run_workflow_and_waitdispatches a workflow and follows the run until it ends or waits on a person, andforge_explain_denialsays why a call was refused. - See Listing jobs and the retired extended toolset.
- Four prompts give an agent a short plan for a common job:
forge_triage_failed_run,forge_act_on_my_approvals,forge_set_up_agentandforge_my_work_today. Each is listed only when every tool group it draws on is on, makes no API call, and waits for the user’s confirmation before any write. - Five resource templates read one run’s Markdown report or timeline, or one workflow, its input schema or a published version’s graph, with the connection’s own credential.
- The
forge_run_workflow_to_outcomeprompt takes a workflow’s name and, optionally, its inputs. It reads the workflow’s input schema, the active version’s capability readiness and the cost forecast, runs that version withforge_run_workflow_and_waitonly after you confirm, follows the run until it ends or waits on an approval, a person or a pause, and reports its outcome. It is listed when theworkflowsandrunstool groups are on.
GET /api/v2/models/admin/slotsand/slots/getread model slots withagents:read;POST /api/v2/models/admin/slots/create,/slots/updateand/slots/deletechange them withgateway:manage.GET /api/v2/models/admin/routing/org-defaultreads the organization’s default model tier routing withworkflows:use, andPOST /api/v2/models/admin/routing/org-default/setsets it withgateway:manage. An agent’s own routing override stays with the Console.POST /api/v2/models/admin/fallback-chains/create,/fallback-chains/updateand/fallback-chains/removemanage fallback chains withgateway:manage; a system chain cannot be removed.GET /api/v2/models/listFallbackChainslists them.GET /api/v2/models/admin/approaching-deprecationlists catalog models whose deprecation date is near, withGET /api/v2/models/list’s public fields plusdeprecationDate; an absent optional field is omitted.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation. - Adding, updating, activating and removing catalog models, and catalog rates, stay with the Console.
POST /api/v2/models/admin/catalog/create,.../catalog/update,.../catalog/removeand.../catalog/toggle-activemanage catalog models bymodelIdwithgateway:manage. Rates andapprovalRequiredstay Console-only: a body carrying one answers400, and no answer carries one.GET .../catalog/suggest-replacementsuggests an active replacement for a model withagents:read.GET .../routing/agents/get,POST .../routing/agents/setandPOST .../routing/agents/deleteread and change an agent’s model tier routing, andGET .../routing/configslists the configs. An agent that is PERSONAL, or that the key does not holdagents:readfor, answers404and is left out of the list.- These routes take an API key. An External App is refused with
403. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
GET /api/v2/models/admin/catalog/search-with-usagesearches the catalog by display name withagents:read, answering every matching model, each withagentCountandassignedAgents.- A model’s usage counts and names only the agents the key holds
agents:readfor, and never a PERSONAL agent or an agent with no home. - The route takes an API key. An External App is refused with
403, and it is reachable from MCP throughforge_call_operation.
GET /api/v2/org-units/admin/drafts/activereads the active org chart draft, andPOST /api/v2/org-units/admin/drafts/createopens one (409when a draft is already open).POST .../drafts/positions/add,/drafts/positions/update,/drafts/positions/move,/drafts/positions/removeand/drafts/org-units/addstage changes in the active draft; each answers404when no draft has the given id, and the position update, move and remove routes also when no position has the given id.GET /api/v2/org-units/admin/snapshotslists published org chart snapshots.- Every route needs
org:manage. Publishing a draft is not on the API yet, so staged changes are applied in the Console. - These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
GET /api/v2/org-units/admin/membershipsandGET /api/v2/org-units/admin/memberships/by-memberare withdrawn. A membership can name a person seated in a customer organization, whom an API key or External App must not reach (the ruleGET /api/v2/workforce/getPersonalready applies), and these routes did not apply it.- They return as routes that leave out, or answer
404for, a person out of the caller’s reach.
POST /api/v2/people/admin/memberships/update-rolechanges a member’s role andPOST .../memberships/removeends a membership, withorg:manage; an ended membership answers409.GET /api/v2/org-units/admin/memberships/by-memberlists a member’s active memberships, with each unit’s name, withworkforce:read.- A member seated in or under a customer organization, an agent seat whose agent the key may not read, or a position with such an assignee is out of an API key’s reach: it answers
404. A position with no assignee is in reach when its own unit is. - These routes take an API key. An External App is refused with
403. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
GET /api/v2/org-units/admin/structure-typesand/structure-types/tierslist the org structure types and tiers withworkforce:read; Create org unit takes one’sidasstructureTypeId.POST /api/v2/org-units/admin/structure-types/create,/structure-types/updateand/structure-types/reorder-tierschange them withorg:manage.GET /api/v2/org-units/admin/memberships/by-memberlists one member’s active org unit memberships withworkforce:read, andGET /api/v2/org-units/admin/scheduled-changeslists scheduled org changes withorg:manage.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
- A route that acts on one org unit now serves an API key granted the permission at that unit or above it, not only at the platform. A key holding the permission nowhere is refused with
403, and a unit outside the key’s grants answers404. GET /api/v2/org-units/admin/membershipslists an org unit’s active memberships withworkforce:read.POST /api/v2/org-units/admin/drafts/org-units/updateand/drafts/org-units/removestage an org unit’s change or removal in the active org chart draft withorg:manage.POST /api/v2/org-units/admin/drafts/capital-partners/addstages a new capital-partner org unit withorg:manage; an invalid code, or a missing name or reason, answers400.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
POST /api/v2/people/admin/workers/createcreates a human worker seat (employee or contractor) for a new person, withorg:manage, and answers the newworkerIdandpersonId.- The email is matched only against people in the caller’s reach, as
POST /api/v2/workforce/createPersondoes. A reachable holder answers409 conflict, which names no one. A malformed email or a blank name answers400 bad_request. An email held only by a person out of reach creates a new person and answers as for an unused email. The route never links a seat to an existing person; linking a sign-in, or an agent seat, stays in the Console. - The route takes an API key. An External App is refused with
403. It takes anIdempotency-Key, and it is reachable from MCP throughforge_call_operation.
GET /api/v2/people/admin/expertise-tagslists expertise tags withworkforce:read, andPOST .../expertise-tags/upsertcreates or updates one withworkforce:manage.POST .../integrity/audits/startstarts a workforce integrity audit withworkforce:manage, andGET .../integrity/runs/getreads a run withworkforce:read.GET .../integrity/person-statusreads the deployment’s person-identity integrity check withworkforce:read.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
POST /api/v2/people/admin/workers/deactivatedeactivates a worker seat withorg:manage.GET .../workers/expertise-tagslists a worker’s expertise tags and levels withworkforce:read, as{ tags, truncated }: at most 200 tags, withtruncated: truewhen the read reached that ceiling and more may exist. AndPOST .../workers/expertise-tags/setsets a worker’s level for a tag withworkforce:manage.- A seat of a person seated in or under a customer organization is out of an API key’s reach: it answers
404. An agent seat is in reach only when the key may read its agent. - These routes take an API key. An External App is refused with
403. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.
GET /api/v2/skills/listSets (skills:read) lists skill sets. With skills:manage,
/skills/createSet, /skills/updateSet, /skills/deleteSet, /skills/addSetMember and
/skills/removeSetMember manage them; with tools:manage, /tools/createSet, /tools/updateSet and
/tools/deleteSet manage workspace tool sets. Each write is idempotent with an Idempotency-Key,
except a tool-set delete, which is never replayed. MCP clients reach them through
forge_call_operation.Reading skill sets in the Console now needs skills:read, as reading tool sets does. A tool set’s
members must be active or deprecated catalog tools. Changing a set’s members, or deleting a skill set,
now reaches every agent holding it at its next dispatch, in the Console too.POST /api/v2/tools/admin/createcreates a draft tool withtools:writeand answers itsid, the sameidGET /api/v2/tools/listanswers.POST /api/v2/tools/admin/update,/set-enabledand/removechange one withtools:manage;removearchives a tool, and removes a tool already archived.POST /api/v2/tools/admin/bulk/deprecateand/bulk/risk-level(withtools:manage) and/bulk/tags(withtools:write) change many tools byidand answer how many changed.POST /api/v2/tools/admin/versions/reinstatemakes an immutable tool version the head again withtools:manage.GET /api/v2/tools/admin/commands/getreads a sandbox command definition bycommandIdwithagents:read, andGET /api/v2/tools/admin/pipedream-appssearches the cached Pipedream app catalog withtools:read.- These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation. A tool’s author and the author of each new sandbox command are the key’s actor:createrefuses acreatedBy, and anaddedByin a sandbox command is ignored. - Adding a Pipedream app as a tool (a browser consent), editing a tool’s governance, importing or exporting the catalog manifest, and replacing a tool’s sandbox command list stay with the Console.
GET /api/v2/trust-fabric/admin/tier3-invocationslists recent Tier 3 free-form command decisions withaudit:read, grouped by disposition: disposition, inferred risk, severity and the command’s hash. A decision never names the run, step or agent it was made for, and never carries its reason or gate messages.GET /api/v2/trust-fabric/admin/tier3-promotion-candidateslists frequent low-risk Tier 3 command patterns by hash, count and last use, with no sample command line.GET /api/v2/trust-fabric/admin/policy-effectivenesslists each policy’s hold count, block rate and last trigger since a start time.- The Tier 3 reads and the hold counts cover only decisions homed in the caller’s
audit:readscope. These routes take an API key: an External App is refused with403, even when it holds the permission. Every route is reachable from MCP throughforge_call_operation.
switches:use at the platform scope, and a reason of at least 8 characters:POST /api/v2/trust-fabric/admin/kill/engageengages the platform kill switch. Releasing it stays in the Console.POST /api/v2/trust-fabric/admin/posture/enforcesets the publish judge toenforce. Moving it towarnoroffstays in the Console.POST /api/v2/trust-fabric/admin/doors/agentsstops or resumes theagentsgovernance door. Thepeopleandapi_keysdoors stay in the Console.
400, and nothing is written. Each control records the calling key as who acted. These routes take an API key: an External App is refused with 403.GET /api/v2/usage/summary?fromDay=&toDay=&groupBy=tool|routeanswers the API’s request counts over at most 31 UTC days, grouped by MCP tool or by route, and by outcome, withplatform:read. An External App is refused with403.- Counts are API requests, folded overnight, so they are a day late. The answer names no key, app, person or MCP client.
- Forge MCP exposes the same read as the resource template
forge://usage/summary/{fromDay}/{toDay}, and throughforge_call_operation.
GET /api/v2/vendors/admin/listlists the vendor registry withvendors:read;POST /api/v2/vendors/admin/create,/updateand/approval-status/setcreate a vendor, edit it and set its approval status withvendors:write.GET .../specsand.../lessonslist a vendor’s API specs and lessons withvendors:read;POST .../specs/attach,/specs/update,/specs/remove,/notes/add,/notes/updateand/notes/retirechange them withvendors:write.GET .../connections/mcp-catalogreads a remote MCP connection’s tool catalog withvendors:read;POST .../links/removeunlinks a tool or procedure from its vendor withvendors:write.- A vendor, spec, note or link id that names no record of that kind answers
404on these routes and in the Console’s matching operations, which now never touch a record of another kind. Removing a spec or link that is already gone succeeds. - These routes take an API key. An External App is refused with
403, even when it holds the permission. Each write takes anIdempotency-Key, and every route is reachable from MCP throughforge_call_operation.

