Import an agent export file
Creates the agent an export file describes in the calling organization, resolved as managedAgentsPreviewAgentImportV2 resolves it with the same choices. The catalog skills the file carries, bundled files included, the agent with its first version, and its memory settings are created in one transaction: a failed import leaves no agent and no skill. A catalog skill whose name a skill here already has is used in place of the file’s copy only when choices names it; otherwise the import is refused. The response names the new agent, its first version and the skills created, with the same report a preview gives. With an Idempotency-Key, a retry after an ambiguous response returns the original result.
Authorizations
Headers
Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.
1 - 256^[!-~]+$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.