Import an agent
Imports an agent from its on-disk folder representation (spec.yaml, instructions.md, skills/, subagents/) packaged as a zip, and creates or updates the agent. Inverse of the export flow: the folder-to-schema conversion runs server-side. The bundle must contain only regular files; symlinks are resolved by the caller at packaging time.
Path parameters
The ID of the agent to create or update.
The ID of the agent to create or update.
Query parameters
The client's preferred locale in rfc5646 format (e.g. en, ja, pt-BR). If omitted, the Accept-Language will be used. If not present or not supported, defaults to the closest match or en.
The offset of the client's timezone in minutes from UTC. e.g. PDT is -420 because it's 7 hours behind UTC.
Headers
Email address of a user on whose behalf the request is intended to be made (should be non-empty only for global tokens).
Auth type being used to access the endpoint (should be non-empty only for global tokens).
Response
Success
Example response
{
"workflowResult": {
"workflow": {
"author": {
"name": "George Clooney",
"obfuscatedId": "abc123"
},
"lastDraftSavedBy": {
"name": "George Clooney",
"obfuscatedId": "abc123"
},
"lastUpdatedBy": {
"name": "George Clooney",
"obfuscatedId": "abc123"
}
}
}
}