HUhubspot
Basic

List prompt runs

Changed on

Retrieve a list of runs for a specific prompt in the Answer Engine Visibility API. This endpoint allows you to filter runs based on creation dates and paginate through results. Useful for tracking the execution history of a specific prompt.

get/marketing/aeo/2027-03-beta/prompts/{promptId}/runs

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/aeo/2027-03-beta/prompts/{promptId}/runs
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.aeo.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.aeo.read

Path parameters

promptIdstring required

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

createdAfterstring
createdAtstring
createdBeforestring
limitinteger

The maximum number of results to display per page.

Response

successful operation

Changes

  • 2027-03-beta3e1835f1fe1dRevision changes
    • info

      the security scope marketing.aeo.write was added to the endpoint's security scheme oauth2

    • info

      the security scope marketing.aeo.read was removed from the endpoint's security scheme oauth2

  • 2027-03-beta53bae9def894Revision changes
    • info

      the security scope marketing.aeo.write was added to the endpoint's security scheme oauth2

    • info

      the security scope marketing.aeo.read was removed from the endpoint's security scheme oauth2