List the Agent versions that use a Prompt template

GET /v1/prompt-templates/{prompt_template_id}/pins

Lists the published Agent versions of the Organization that pin a version of the template as their Agent layer or name it as their Organization layer, newest first, with whether each is its Agent's active version (1.58.0). An Agent that names no layer and receives the default one is not listed. A template of another Organization is not found.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the prompts:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/prompt-templates/ptpl_.../pins" \
  -H "Authorization: Bearer $VOCAL_API_KEY"

const response = await fetch(`${process.env.VOCAL_API}/v1/prompt-templates/ptpl_.../pins`, {
  headers: {
    Authorization: `Bearer ${process.env.VOCAL_API_KEY}`,
  },
});
console.log(response.status, await response.text());

import os

import requests

response = requests.get(
    f"{os.environ['VOCAL_API']}/v1/prompt-templates/ptpl_.../pins",
    headers={
        "Authorization": f"Bearer {os.environ['VOCAL_API_KEY']}",
    },
)
print(response.status_code, response.text)

Parameters

Responses

Fields of the 200 answer

The shape is PromptTemplatePinList.