--- title: "Retrieve revisions for a given definition" method: GET path: "/automation/actions/2026-03/{appId}/{definitionId}/revisions" tags: ["Revisions"] --- # Retrieve revisions for a given definition `GET /automation/actions/2026-03/{appId}/{definitionId}/revisions` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/automation/actions/2026-03/{appId}/{definitionId}/revisions` - Auth: one of: - HTTP bearer - API key in query parameter `hapikey` - none 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 - AutomationActionsCollectionResponsePublicActionRevisionForwardPaging - `paging` ForwardPaging - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response - `after` string, required: A paging cursor token for retrieving subsequent pages. - `link` string: A URL that can be used to retrieve the next page results. - `results` AutomationActionsPublicActionRevision[], required - `createdAt` string, date-time, required: The date and time when the action revision was created. - `definition` AutomationActionsPublicActionDefinition, required - `actionUrl` string, required - `archivedAt` integer - `executionRules` AutomationActionsPublicExecutionTranslationRule[] - `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` AutomationActionsPublicActionFunctionIdentifier[], required - `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 - `inputFieldDependencies` union[] - union - AutomationActionsPublicSingleFieldDependency - `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 - AutomationActionsPublicConditionalSingleFieldDependency - `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 - `inputFields` AutomationActionsPublicInputFieldDefinition[], required - `isRequired` boolean, required: Indicates whether the input field is mandatory. - `supportedValueTypes` string[] - `typeDefinition` AutomationActionsPublicFieldTypeDefinition, 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` AutomationActionsPublicOption[], required - `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 - `objectRequestOptions` AutomationActionsPublicObjectRequestOptions - `properties` string[], required - `objectTypes` string[], required - `outputFields` AutomationActionsOutputFieldDefinition[] - `typeDefinition` AutomationActionsFieldTypeDefinition, 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` AutomationActionsOption[], required - `description` string, required: A description of the option. - `displayOrder` integer, required: The position of the item relative to others in the list. - `doubleData` number, required: A numerical value associated with the option. - `hidden` boolean, required: Whether the option is displayed in HubSpot's UI. - `label` string, required: A user-friendly label that identifies the option. - `readOnly` boolean, required: Whether the option is read-only. - `value` string, required: The actual value of the option. - `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. - AutomationActionsIntegerFieldSchema - … - AutomationActionsLongFieldSchema - … - AutomationActionsDoubleFieldSchema - … - AutomationActionsStringFieldSchema - … - AutomationActionsBooleanFieldSchema - … - AutomationActionsArrayFieldSchema - … - AutomationActionsObjectFieldSchema - … - `type` 'bool' | 'currency_number' | 'date' | 'datetime' | 'enumeration' | 'json' | 'number' | 'object_coordinates' | 'phone_number' | 'string', 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 - `revisionId` string, required - `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 > 14 revisions in range; 1 not diffed, 2 could not be searched. - **2026-05-27** `f9c7181056c5`: 42 info - removed the `ARRAY` enum value from the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #1: INTEGER]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #2: LONG]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #3: DOUBLE]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `results/items/definition/outputFields/items/typeDefinition/schema/oneOf[subschema #4: STRING]/type` response property for the response status `200` - …38 more - **2026-04-08** `b0d8bc008db9`: 1 info - api operation id `get-/automation/actions/2026-03/{appId}/{definitionId}/revisions_getPage` removed and replaced with `get-/automation/actions/2026-03/{appId}/{definitionId}/revisions` - …earlier changes not shown [Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/automation/actions/2026-03/:appId/:definitionId/revisions/get.md) --- [API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)