Set the active org for this session. Subsequent tool calls will use this org by default.

List all configured orgs with their auth status and show the current session/default org.

Add or update credentials for an org. Validates the credentials by signing in.

Remove stored credentials for an org.

List all entities of a given type in an org.

Get the full details of a specific entity by ID. Returns the latest version.

Create a new entity of the given type. Provide the entity data as a JSON string or object.

Update an existing entity by creating a new version. Provide the full version data.

Delete an entity. This is irreversible.

Create a new agent.

Update an agent by creating a new version. The initial version requires: initials, identity, background, behaviors, and communication_patterns. Subsequent versions can include only changed fields. Do NOT include agent_name, greeting, dynamic_behavior_set_ids, user_dimension_ids, or persona_ids.

Create a new context graph (state machine that defines conversation flow).

Update a context graph by creating a new version. All fields are required. The terminal state must have exactly one action.

Create a new service linking an agent and context graph into a deployable unit. IMPORTANT: Both the agent and context graph must already have at least one version before creating the service.

Update an existing service. Only provided fields are changed.

Create a new tool (external action the agent can invoke).

Update tool metadata (description and tags). Tool versions are published separately.

Create a new metric for evaluating conversations.

Update a metric. Only provided fields are changed.

Create a new simulation persona with its initial version.

Update persona metadata (tags). Use forge_entity_update for version changes.

Create a new simulation scenario with its initial version.

Update scenario metadata (tags). Use forge_entity_update for version changes.

Create a new dynamic behavior set (runtime instructions injected based on triggers).

Update dynamic behavior set metadata. Only provided fields are changed.

Create a new simulation unit test.

Update a unit test. Only provided fields are changed.

Create a new unit test set (collection of unit tests to run together).

Update a unit test set. Only provided fields are changed.

Run a quick smoke test against a service. Creates a conversation, sends a message, and returns the agent's response.

Run an automated multi-turn conversation simulation against a service.

Get debugging insights for a conversation, including state transitions and triggered behaviors.

Run on-demand metric evaluation against a conversation.

List all version sets for a service, showing pinned versions.

Create or update a version set for a service. Use latest=true to pin to the current latest versions.

Promote one version set to another (e.g. preview -> release).

Roll back an entity to a previous version. Lists available versions for selection.