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, in full, the text the new agent would follow. 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
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Body
An agent export file to import into the calling organization, with where each of its references lands.
A recursion.agent-export document as the console's Export writes it, format version 1 or 2. Version 2 carries catalog skills whole, with their bundled files. The file is at most 33554432 bytes.
Where each item of the preview lands, by its key: the id of one of its candidates, or an empty string to leave it out. 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.
Name for the new agent. Omit to keep the name in the file.
256Response
OK
Whether an import with the same file and choices would be accepted now.
The text the new agent follows, in full: its system prompt, rubric, skills and team settings, and its other settings. A file can come from someone else, so this is for a person to read before importing.
Every reference with a choice, in file order.
Why it would not, when it would not.