Import a prompt library
POST/api/v1/agent-profiles/import
Bulk-converts a source prompt library into profiles and reusable fragments. Conversion happens at import time: prompts are rewritten to the platform template syntax and variable specifications are derived from usage. The platform never interprets the source DSL when serving a turn.
Existing rows cause the import to stop at the first conflict with ALREADY_EXISTS,
unless overwrite is enabled. In overwrite mode, existing profiles and fragments
are replaced. Writes apply fragments before profiles and are not atomic across
rows: a later failure can leave earlier writes in place. Re-read the library and
reconcile it before retrying.
Request
Responses
- 200
Converted profiles and fragments, as stored
Document ID: DOC-MA-profiles-prompts-api-importAgentProfiles. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-MA-profiles-prompts-api-importAgentProfiles#overview |
| Request | DOC-MA-profiles-prompts-api-importAgentProfiles#request |
| Responses | DOC-MA-profiles-prompts-api-importAgentProfiles#responses |