Preview importing an agent export file
Resolves an agent export file against the calling organization exactly as managedAgentsImportAgentV2 would, and writes nothing. Each vault, integration connection, team member and skill the file names is matched by name; items lists every one with a choice to make, with its candidates here. A vault is granted only with the credentials the file names that match one credential here exactly; built-in and native integrations are never connected wider than the file. The report says what carries over and what is left out, and instructions shows the text the new agent would follow from the file, leaving out a skill’s bundled files and the text of a skill mapped to an existing one. importable is false, with blockedReason, when the import would be refused: an evaluator, a model or setting this organization does not accept, or a catalog skill whose name a skill here already has and that is not chosen to replace it. A preview reserves nothing; the import resolves the same choices again.
Authorizations
Headers
Body
An agent export file to import into the calling organization, with where each of its references lands.
Where each item of the preview lands, by its key: the id of one of its candidates, or an empty string for no mapping. No mapping leaves out a vault, connection or team member and imports a skill item's own copy; a catalog skill item creates the skill unless a skill here has its name, which refuses the import. An item not named here takes its default: its only candidate when it has exactly one, otherwise nothing. A skill item defaults to importing the file's own copy, and a catalog skill item to creating the skill when no skill here has its name.
Response
OK
The text the new agent follows from this file: its system prompt, rubric, skill text, team settings, and other settings. It leaves out a skill's bundled files and the text of a skill mapped to an existing one, so review those separately. A file can come from someone else, so this is for a person to read before importing.