List available prompt versions

This code sample demonstrates how to list all versions of a prompt.

Code sample

Python

Before trying this sample, follow the Python setup instructions in the Vertex AI quickstart using client libraries. For more information, see the Vertex AI Python API reference documentation.

To authenticate to Vertex AI, set up Application Default Credentials. For more information, see Set up authentication for a local development environment. 

import vertexai
from vertexai.preview.prompts import Prompt
from vertexai.preview import prompts

# Initialize vertexai
vertexai.init(project=PROJECT_ID, location="us-central1")

# Create local Prompt
prompt = Prompt(
    prompt_name="zoologist",
    prompt_data="Which animal is the fastest on earth?",
    model_name="gemini-2.0-flash-001",
    system_instruction="You are a zoologist. Answer in a short sentence.",
)
# Save Prompt to online resource.
prompt1 = prompts.create_version(prompt=prompt)
prompt_id = prompt1.prompt_id

# Get prompt a prompt from list
prompt_versions_metadata = prompts.list_versions(prompt_id=prompt_id)

# Get a specific prompt version from the versions metadata list
prompt1 = prompts.get(
    prompt_id=prompt_versions_metadata[0].prompt_id,
    version_id=prompt_versions_metadata[0].version_id,
)

print(prompt1)
# Example response:
# Which animal is the fastest on earth?

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.