---
schema_version: "1"
id: 740c9de0256d5319bc539d811f30a18f925264380841c6191c6653a041a0e3af
title: Move Agents Between Orgs More Easily with Simplified Agent Metadata Types
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/release-notes/264-0-0/rn_agentforce_metadata.md
canonical_url: https://help.salesforce.com/s/articleView?id=release-notes.rn_agentforce_metadata.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 12e0679da765ae98fb375b01e2d840d93aaab3f4006f08a53f572292c8a8ecb6
description: Starting in API version 68.0, we’ve streamlined Agentforce agent metadata types to make it easier to retrieve and deploy agents. Previously, moving an agent from sandbox to production required at least three metadata types. Plus, you had to manually add every Apex class, flow, and prompt template associated with an agent action, making sure to indicate the correct agent version. With the new AiAgentDefinition and AiAgentDefinitionVersion types, Salesforce CLI now retrieves the agent and all its dependencies automatically.
products:
  - Cross Cloud
release: "264"
---
# Move Agents Between Orgs More Easily with Simplified Agent Metadata Types

Starting in API version 68.0, we’ve streamlined Agentforce agent metadata types to make it easier to retrieve and deploy agents. Previously, moving an agent from sandbox to production required at least three metadata types. Plus, you had to manually add every Apex class, flow, and prompt template associated with an agent action, making sure to indicate the correct agent version. With the new AiAgentDefinition and AiAgentDefinitionVersion types, Salesforce CLI now retrieves the agent and all its dependencies automatically.

**Where:** This change applies to Lightning Experience in Enterprise, Performance, Unlimited, and Developer Editions with Foundations or Agentforce 1 Editions. Setup for AI agents is available on the desktop site.

**When:** This change is available as Winter ’27 rolls out, starting with preview sandboxes the week of August 24, 2026.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-release-notes-salesforce_release_notes-264-0-0-production-enus/550ba85b-db1a-4608-9cd4-9a65ec96e1fa/images/icon_note.png)

Note To use the new metadata types to move agents between orgs, both orgs must be in API version 68.0. While your sandbox org is in Winter ʼ27 and your production org is in Summer ʼ26, continue to use the previous metadata types.

**How:** To use the simplified metadata types, update Salesforce CLI to the latest version and update your package manifest to reference `AiAgentDefinition` and `AiAgentDefinitionVersion`. To retrieve an agent and its dependencies, run `sf project retrieve start --metadata AiAgentDefinitionVersion --root-type-with-dependencies AiAgentDefinitionVersion`.

You can continue to use the previous metadata types `AiAuthoringBundle`, `Bot`, and `BotVersion` by specifying API version 67.0 in your package manifest.

`AiAgentDefinition` and `AiAgentDefinitionVersion` are supported in second-generation managed packaging (managed 2GP) only.

#### See Also

- [_Agentforce Developer Guide_: Use Metadata to Move an Agent to a New Org](https://developer.salesforce.com/docs/ai/agentforce/guide/agent-dx-deploy-metadata.html)