Skip to content
API referenceList a prompt's audit log

List a prompt's audit log

GET/v1/prompts/{slug}/audit-log

List a prompt's audit log.

Returns the changes made to the prompt (creation, versions saved and published, labels, rollbacks, test runs), newest first. Requires membership of the prompt's workspace (organization admins have it). 404 when the prompt does not exist.

Authorization

  • AuthorizationBearer va_

    A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Path parameters

  • slugstringrequired

    the prompt's slug

Query parameters

  • organizationstringrequired

    slug of the organization that owns it

  • pageinteger<int32>

    page number, from 1. Default 1

  • page_sizeinteger<int32>

    entries per page. Default 50, at most 200

Responses

200application/json
  • totalinteger<int64>

    Number of entries in the whole log.

  • pageinteger<int32>

    The page number, from 1.

  • page_sizeinteger<int32>

    Entries per page.

  • entriesobject[]

    The entries on this page.

    Child attributes
    • idstring

      The entry's unique id (UUID).

    • prompt_idstring

      Id (UUID) of the prompt.

    • actionenum<string>

      What happened: CREATE (prompt created), VERSION_SAVE (version saved), PUBLISH (version published), LABEL_ADD (label set), LABEL_REMOVE (label removed), ROLLBACK (an earlier version saved again as a new version), DELETE (prompt deleted) or TEST_RUN (test cases run).

      One of "CREATE", "VERSION_SAVE", "PUBLISH", "LABEL_ADD", "LABEL_REMOVE", "ROLLBACK", "DELETE", "TEST_RUN"

    • actor_idstring

      Identifier of the caller (user or API key) that made the change, or unknown when the caller could not be identified.

    • detailmap<string, object>

      Details of the change, by action: for example slug and name, version_number, labels, label, from_version and to_version, or pass_count and fail_count.

    • created_atstring<date-time>

      When the change was made (ISO 8601).

NVIDIA Inception Program member

VectorAxis is built by GK Labs, a member of NVIDIA Inception.