--- title: "Retrieve revisions for a given definition" method: GET path: "/automation/actions/2026-09/{appId}/{definitionId}/revisions" tags: ["Revisions"] --- # Retrieve revisions for a given definition `GET /automation/actions/2026-09/{appId}/{definitionId}/revisions` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}/revisions` - Auth: API key in query parameter `hapikey` Retrieve the versions of a definition by ID. ## Path parameters - `appId` integer, required - `definitionId` string, required ## Query parameters - `after` string - `limit` integer ## Response `200` successful operation - CollectionResponsePublicActionRevisionForwardPaging - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page. - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required: A string token that indicates the position after the last item on the current page. This token is used to fetch the next page of results. - `link` string: A string URL that provides a direct link to the next page of results. - `results` PublicActionRevision[], required: An array of PublicActionRevision objects, each representing a specific revision of a public action definition. - `createdAt` string, date-time, required: The date and time when the action revision was created. - `definition` PublicActionDefinition, required - `actionUrl` string, required: The URL endpoint where the action is executed. It is a string. - `archivedAt` integer: A Unix timestamp in milliseconds representing when the action was archived. It is an integer. - `executionRules` PublicExecutionTranslationRule[]: An array of execution translation rules for the action, where each item is a PublicExecutionTranslationRule. - `conditions` object, required: Defines the conditions that must be met for the execution rule to apply. - `labelName` string, required: Specifies the name of the label associated with the execution rule. - `functions` PublicActionFunctionIdentifier[], required: An array of function identifiers associated with the action, where each item is a PublicActionFunctionIdentifier. - `functionType` 'POST_ACTION_EXECUTION' | 'POST_FETCH_OPTIONS' | 'PRE_ACTION_EXECUTION' | 'PRE_FETCH_OPTIONS', required: The type of function, with accepted values: POST_ACTION_EXECUTION, POST_FETCH_OPTIONS, PRE_ACTION_EXECUTION, PRE_FETCH_OPTIONS. - `id` string: The unique identifier for the function. - `id` string, required: The unique identifier for the action definition. It is a string. - `inputFieldDependencies` union[]: An array of dependencies between input fields, where each item can be a PublicSingleFieldDependency or PublicConditionalSingleFieldDependency. - union - PublicSingleFieldDependency - `controllingFieldName` string, required: The name of the field that controls the dependency. - `dependencyType` 'SINGLE_FIELD', required: The type of dependency, with the default value being 'SINGLE_FIELD'. - `dependentFieldNames` string[], required: An array of strings representing the names of fields that are dependent on the controlling field. - PublicConditionalSingleFieldDependency - `controllingFieldName` string, required: The name of the field that determines the dependency. - `controllingFieldValue` string, required: The value of the controlling field that triggers the dependency. - `dependencyType` 'CONDITIONAL_SINGLE_FIELD', required: The type of dependency, with the default value being CONDITIONAL_SINGLE_FIELD. - `dependentFieldNames` string[], required: An array of strings representing the names of fields that are dependent on the controlling field. - `inputFields` PublicInputFieldDefinition[], required: An array of input field definitions required for the action. Each item is a PublicInputFieldDefinition object. - `isRequired` boolean, required: Indicates whether the input field is mandatory. - `supportedValueTypes` string[]: An array indicating the types of values that the input field can support. Valid values include 'STATIC_VALUE' and 'OBJECT_PROPERTY'. - `typeDefinition` PublicFieldTypeDefinition, required - `description` string: A detailed explanation of the field's purpose. - `fieldType` 'booleancheckbox' | 'calculation_equation' | 'checkbox' | 'date' | 'file' | 'html' | 'number' | 'phonenumber' | 'radio' | 'select' | 'text' | 'textarea': The type of field, with accepted values including booleancheckbox, calculation_equation, checkbox, date, file, html, number, phonenumber, radio, select, text, and textarea. - `helpText` string: Additional information or guidance about the field. - `label` string: A user-friendly name for the field. - `name` string, required: The internal name used to identify the field. - `options` PublicOption[], required: An array of options available for the field, each defined by the PublicOption schema. - `description` string: A description of the option. - `displayOrder` integer: The position of the option relative to others in the list. - `label` string, required: A user-friendly label that identifies the option. - `value` string, required: The actual value of the option. - `optionsUrl` string: A URL that provides options for the field. - `referencedObjectType` 'OWNER': The type of object that the field references, with accepted values including OWNER. - `type` 'bool' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string', required: The data type of the field, with accepted values including bool, date, datetime, enumeration, json, number, object_coordinates, phone_number, and string. - `labels` object, required: An object containing labels for the action, with each property being a PublicActionLabels object. - `objectRequestOptions` PublicObjectRequestOptions - `properties` string[], required: An array of strings representing the names of the properties to be requested. Each string in the array specifies a property of the object that should be included in the response. - `objectTypes` string[], required: An array of strings representing the types of objects associated with the action. - `outputFields` OutputFieldDefinition[]: An array of output field definitions produced by the action. Each item is an OutputFieldDefinition object. - `typeDefinition` FieldTypeDefinition, required - `description` string: A detailed explanation of the field's purpose and usage. - `externalOptions` boolean, required: Indicates whether the field's options are sourced externally. - `externalOptionsReferenceType` string: Specifies the type of external reference for options. - `fieldType` 'booleancheckbox' | 'calculation_equation' | 'calculation_read_time' | 'calculation_rollup' | 'calculation_score' | 'checkbox' | 'date' | 'file' | 'html' | 'number' | 'phonenumber' | 'radio' | 'select' | 'text' | 'textarea' | 'unknown': Describes the field's type in the UI, with accepted values like booleancheckbox, calculation_equation, checkbox, date, file, html, number, phonenumber, radio, select, text, textarea, unknown. - `helpText` string: Additional information or guidance about the field. - `label` string: The user-friendly label for the field. - `name` string, required: The unique identifier for the field. - `options` Option[], required: An array of options available for the field, each represented by an Option object. - `description` string, required: A string providing additional details about the option. - `displayOrder` integer, required: An integer indicating the order in which the option should be displayed relative to other options. - `doubleData` number, required: A numerical value associated with the option. - `hidden` boolean, required: A boolean indicating whether the option is hidden from the user interface. - `label` string, required: The display name of the option, shown to users. It is a string. - `readOnly` boolean, required: A boolean indicating whether the option is read-only and cannot be modified. - `value` string, required: The internal value of the option, used in data processing. It is a string. - `optionsUrl` string: A URL that provides options for the field. - `referencedObjectType` 'ABANDONED_CART' | 'ACCEPTANCE_TEST' | 'AD' | 'AD_ACCOUNT' | 'AD_CAMPAIGN' | 'AD_GROUP' | 'AI_FORECAST' | 'ALL_PAGES' | 'APPROVAL' | 'APPROVAL_STEP' | 'ATTRIBUTION' | 'AUDIENCE' | 'AUTOMATION_JOURNEY' | 'AUTOMATION_PLATFORM_FLOW' | 'AUTOMATION_PLATFORM_FLOW_ACTION' | 'BET_ALERT' | 'BET_DELIVERABLE_SERVICE' | 'BLOG_LISTING_PAGE' | 'BLOG_POST' | 'CALL' | 'CAMPAIGN' | 'CAMPAIGN_BUDGET_ITEM' | 'CAMPAIGN_SPEND_ITEM' | 'CAMPAIGN_STEP' | 'CAMPAIGN_TEMPLATE' | 'CAMPAIGN_TEMPLATE_STEP' | 'CART' | 'CASE_STUDY' | 'CHATFLOW' | 'CLIP' | 'CMS_URL' | 'COMBO_EVENT_CONFIGURATION' | 'COMMERCE_PAYMENT' | 'COMMUNICATION' | 'COMPANY' | 'CONTACT' | 'CONTACT_CREATE_ATTRIBUTION' | 'CONTENT' | 'CONTENT_AUDIT' | 'CONTENT_AUDIT_PAGE' | 'CONVERSATION' | 'CONVERSATION_INBOX' | 'CONVERSATION_SESSION' | 'CRM_OBJECTS_DUMMY_TYPE' | 'CRM_PIPELINES_DUMMY_TYPE' | 'CTA' | 'CTA_VARIANT' | 'DATA_PRIVACY_CONSENT' | 'DATA_SYNC_STATE' | 'DEAL' | 'DEAL_CREATE_ATTRIBUTION' | 'DEAL_REGISTRATION' | 'DEAL_SPLIT' | 'DISCOUNT' | 'DISCOUNT_CODE' | 'DISCOUNT_TEMPLATE' | 'EMAIL' | 'ENGAGEMENT' | 'EXPORT' | 'EXTERNAL_WEB_URL' | 'FEE' | 'FEEDBACK_SUBMISSION' | 'FEEDBACK_SURVEY' | 'FILE_MANAGER_FILE' | 'FILE_MANAGER_FOLDER' | 'FOLDER' | 'FORECAST' | 'FORM' | 'FORM_SUBMISSION_INBOUNDDB' | 'GOAL_TARGET' | 'GOAL_TARGET_GROUP' | 'GOAL_TEMPLATE' | 'GSC_PROPERTY' | 'HUB' | 'IMPORT' | 'INVOICE' | 'KEYWORD' | 'KNOWLEDGE_ARTICLE' | 'LANDING_PAGE' | 'LEAD' | 'LINE_ITEM' | 'MARKETING_CALENDAR' | 'MARKETING_CAMPAIGN_UTM' | 'MARKETING_EMAIL' | 'MARKETING_EVENT' | 'MARKETING_EVENT_ATTENDANCE' | 'MARKETING_SMS' | 'MEDIA_BRIDGE' | 'MEETING_EVENT' | 'MIC' | 'NOTE' | 'OBJECT_LIST' | 'ORDER' | 'OWNER' | 'PARTNER_ACCOUNT' | 'PARTNER_CLIENT' | 'PARTNER_CLIENT_REVENUE' | 'PARTNER_SERVICE' | 'PAYMENT_LINK' | 'PAYMENT_SCHEDULE' | 'PAYMENT_SCHEDULE_INSTALLMENT' | 'PERMISSIONS_TESTING' | 'PLAYBOOK' | 'PLAYBOOK_QUESTION' | 'PLAYBOOK_SUBMISSION' | 'PLAYBOOK_SUBMISSION_ANSWER' | 'PLAYLIST' | 'PLAYLIST_FOLDER' | 'PODCAST_EPISODE' | 'PORTAL' | 'PORTAL_OBJECT_SYNC_MESSAGE' | 'POSTAL_MAIL' | 'PRIVACY_SCANNER_COOKIE' | 'PRODUCT' | 'PRODUCT_OR_FOLDER' | 'PROPERTY_INFO' | 'PROSPECTING_AGENT_CONTACT_ASSIGNMENT' | 'PUBLISHING_TASK' | 'QUARANTINED_SUBMISSION' | 'QUOTA' | 'QUOTE' | 'QUOTE_FIELD' | 'QUOTE_MODULE' | 'QUOTE_MODULE_FIELD' | 'QUOTE_TEMPLATE' | 'RESTORABLE_CRM_OBJECT' | 'ROSTER' | 'ROSTER_MEMBER' | 'SALES_DOCUMENT' | 'SALES_TASK' | 'SALES_WORKLOAD' | 'SALESFORCE_SYNC_ERROR' | 'SCHEDULING_PAGE' | 'SCHEMAS_BACKEND_TEST' | 'SCORE_CONFIGURATION' | 'SEQUENCE' | 'SEQUENCE_ENROLLMENT' | 'SEQUENCE_STEP' | 'SEQUENCE_STEP_ENROLLMENT' | 'SERVICE' | 'SITE_PAGE' | 'SNIPPET' | 'SOCIAL_BROADCAST' | 'SOCIAL_CHANNEL' | 'SOCIAL_POST' | 'SOCIAL_PROFILE' | 'SOX_PROTECTED_DUMMY_TYPE' | 'SOX_PROTECTED_TEST_TYPE' | 'SUBMISSION_TAG' | 'SUBSCRIPTION' | 'TASK' | 'TASK_TEMPLATE' | 'TAX' | 'TEMPLATE' | 'TICKET' | 'UNKNOWN' | 'UNSUBSCRIBE' | 'USER' | 'VIEW' | 'VIEW_BLOCK' | 'WEB_INTERACTIVE': Indicates the type of object that the field references, with accepted values like OWNER. - `schema` union, required: Defines the structure and constraints of the field. - IntegerFieldSchema - … - LongFieldSchema - … - DoubleFieldSchema - … - StringFieldSchema - … - BooleanFieldSchema - … - ArrayFieldSchema - … - ObjectFieldSchema - … - UnknownFieldSchema - … - `type` 'bool' | 'currency_number' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string' | 'time_range', required: Specifies the data type of the field, with accepted values like bool, date, datetime, enumeration, json, number, object_coordinates, phone_number, string. - `useChirp` boolean, required: Specifies whether the field uses the Chirp feature. - `published` boolean, required: A boolean indicating whether the action is published and available for use. - `revisionId` string, required: The unique identifier for the current revision of the action definition. It is a string. - `id` string, required: The unique identifier for the action revision. - `revisionId` string, required: The unique identifier for the specific revision of the action. ## Other responses - `default`: An error occurred. ## Changes - **2026-10-10** (2026-09) `5b95e5eb45d5`: 2 warning - added the new `OBJECT_TYPE` enum value to the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #4: STRING]/format` response property for the response status `200` - added the new `OBJECT_TYPE` enum value to the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #6: ARRAY]/items/oneOf[subschema #4: STRING]/format` response property for the response status `200` - **2026-09-28** (2026-09) `5b95e5eb45d5`: 2 warning - added the new `OBJECT_TYPE` enum value to the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #4: STRING]/format` response property for the response status `200` - added the new `OBJECT_TYPE` enum value to the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #6: ARRAY]/items/oneOf[subschema #4: STRING]/format` response property for the response status `200` - **2026-09-11** (2026-09) `a516396e0463`: 2 info - the endpoint scheme security `developer_hapikey` was added to the API - the endpoint scheme security `oauth2` was removed from the API - …earlier changes not shown [Operation history](https://skmtc.dev/hubspot/apis/automation-actions-v4/changes/automation/actions/2026-09/:appId/:definitionId/revisions/get.md) --- [API](https://skmtc.dev/hubspot/apis/automation-actions-v4.md) - [All operations](https://skmtc.dev/hubspot/apis/automation-actions-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/automation-actions-v4/revisions/bfab10ea153c?raw)