Skip to main content

List a profile's versions

POST 
/api/v1/agent-profiles/versions

Returns stored profile versions newest first. Use a version with get to inspect that profile record. It does not establish what a past turn ran: actual fragment versions, resolved variables, renderer and effective generation settings must also be captured. A profile that never existed returns an empty list.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build a reusable assistant profile

Request​

Responses​

Version history, descending

Use the profileId of an existing profile in your project.​

Section ID: DOC-MA-profiles-prompts-api-listAgentProfileVersions#example-agent-profiles-listAgentProfileVersions-request

Request example

{
  "profileId": "support-assistant"
}

Guide request for Recipe: investigate a change and restore earlier content. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-profiles-prompts-api-listAgentProfileVersions#example-cookbook-managed-agents-profiles-prompts-index-04-request

Request example

{
  "profileId": "nutrition_coach"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-MA-profiles-prompts-api-listAgentProfileVersions#example-agent-profiles-listAgentProfileVersions-response

Response example

{
  "versions": [
    {
      "version": 1,
      "createdAt": "2026-09-16T12:00:00Z"
    }
  ]
}

Illustrative response for Recipe: investigate a change and restore earlier content. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-profiles-prompts-api-listAgentProfileVersions#example-cookbook-managed-agents-profiles-prompts-index-json-03-response

Response example

{
  "versions": [
    {
      "version": 3,
      "createdAt": "2026-08-14T10:22:41Z"
    },
    {
      "version": 2,
      "createdAt": "2026-07-02T16:04:09Z"
    },
    {
      "version": 1,
      "createdAt": "2026-06-19T09:11:55Z"
    }
  ]
}

Document ID: DOC-MA-profiles-prompts-api-listAgentProfileVersions. Section identities and revisions.

SectionStable reference
List a profile's versionsDOC-MA-profiles-prompts-api-listAgentProfileVersions#overview
RequestDOC-MA-profiles-prompts-api-listAgentProfileVersions#request
ResponsesDOC-MA-profiles-prompts-api-listAgentProfileVersions#responses