---
title: "Lists the agent's saved system prompt versions."
method: GET
path: "/agents/{agentId}/systempromptversions"
tags: ["customAgents"]
---

# Lists the agent's saved system prompt versions.

`GET /agents/{agentId}/systempromptversions`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/agents/{agentId}/systempromptversions`
- Auth: HTTP bearer

Lists the saved system prompt versions for the specified custom agent.
            Use a returned version id with the system prompt restore endpoint to restore an earlier prompt.
            <Check title="Required Permissions" icon="key">The user must have read access to the agent.</Check>

## Path parameters

- `agentId` string, uuid, required

## Response `200`

OK

- SystemPromptVersionResponseModel[]
  - `id` string, uuid: The prompt version id.
  - `agentId` string, uuid: The agent id.
  - `versionNumber` integer: The version number, assigned in order of creation.
  - `isCurrent` boolean: Whether this is the agent's current system prompt.
  - `systemPrompt` string, nullable: The system prompt.
  - `createdOn` string, date-time, nullable: The creation time of the system prompt version.
  - `createdBy` string, uuid, nullable: The user who created the system prompt version.

## Other responses

- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-13** `d116d3e9e7d6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/awork-io/apis/api-v1-reference/changes/agents/:agentId/systempromptversions/get.md)

---

[API](https://skmtc.dev/awork-io/apis/api-v1-reference.md) - [All operations](https://skmtc.dev/awork-io/apis/api-v1-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/awork-io/apis/api-v1-reference/revisions/81151fac7e79?raw)