List Prompt Revisions

List prompt revisions with optional filtering.

Returns prompt revisions matching the criteria. If project_name is provided, it resolves to project_id. If no filters are provided, returns all prompt revisions for the account.

GET

/v1/prompt-revisions

Authorization

`X-API-KEY`<token>

In: header

Query Parameters

`project_id`Project Id

Filter by project ID

`project_name`Project Name

Filter by project name

`prompt_id`Prompt Id

Filter by prompt definition ID

`prompt_name`Prompt Name

Filter by prompt definition name

`prompt_name_startswith`Prompt Name Startswith

Filter by prompt definition name prefix

`revision_id`Revision Id

Filter by specific revision ID

`revision`Revision

Filter by revision number

`latest_revision_only`Latest Revision Only

Only return the latest revision for each prompt

Default: false

`label`Label

Filter by revisions that have this label

`normalized_body_sha256`Normalized Body Sha256

Filter by SHA-256 hash prefix of prompt body with whitespace stripped from start and end

`limit`Limit

Maximum number of records to return

Default: 1000

`offset`Offset

Number of records to skip

Default: 0

curl -X GET "https://api.patronus.ai/v1/prompt-revisions?project_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&project_name=string&prompt_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&prompt_name=string&prompt_name_startswith=string&revision_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&revision=0&latest_revision_only=false&label=string&normalized_body_sha256=string&limit=1000&offset=0" \
  -H "X-API-KEY: <token>"

Successful Response

{
  "prompt_revisions": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "prompt_definition_id": "03a177e8-e6c3-4579-9b5a-f1a28527d534",
      "prompt_definition_name": "string",
      "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
      "project_name": "string",
      "revision": 0,
      "body": "string",
      "normalized_body_sha256": "string",
      "metadata": {},
      "labels": [
        "string"
      ],
      "created_at": "2019-08-24T14:15:22Z"
    }
  ]
}

List Prompt Revisions

Authorization

X-API-KEY<token>

Query Parameters

project_idProject Id

project_nameProject Name

prompt_idPrompt Id

prompt_namePrompt Name

prompt_name_startswithPrompt Name Startswith

revision_idRevision Id

revisionRevision

latest_revision_onlyLatest Revision Only

labelLabel

normalized_body_sha256Normalized Body Sha256

limitLimit

offsetOffset

Response

TypeScript