--- title: "Retrieve a specific revision of a definition" method: GET path: "/automation/actions/2026-03/{appId}/{definitionId}/revisions/{revisionId}" tags: ["Revisions"] --- # Retrieve a specific revision of a definition `GET /automation/actions/2026-03/{appId}/{definitionId}/revisions/{revisionId}` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/automation/actions/2026-03/{appId}/{definitionId}/revisions/{revisionId}` - Auth: one of: - HTTP bearer - API key in query parameter `hapikey` - none Retrieve a specific revision of a definition by revision ID. ## Path parameters - `appId` integer, required - `definitionId` string, required - `revisionId` string, required ## Response `200` successful operation - AutomationActionsPublicActionRevision - `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 - `maximum` integer: The maximum value allowed for the integer field. - `minimum` integer: The minimum value allowed for the integer field. - `type` 'INTEGER', required: The type of the field, which is set to INTEGER. - AutomationActionsLongFieldSchema - `maximum` integer: The maximum value allowed for the long field. - `minimum` integer: The minimum value allowed for the long field. - `type` 'LONG', required: The type of the field, which is LONG by default. - AutomationActionsDoubleFieldSchema - `maximum` number: The maximum allowable value for the double field. - `minimum` number: The minimum allowable value for the double field. - `type` 'DOUBLE', required: Indicates the field type as DOUBLE. - AutomationActionsStringFieldSchema - `format` 'DATE' | 'DATE_TIME' | 'OBJECT_COORDINATE' | 'TIME' | 'URI': Specifies the format of the string, with accepted values: DATE, DATE_TIME, OBJECT_COORDINATE, TIME, URI. - `type` 'STRING', required: Indicates that the type is a string, with the default value being STRING. - AutomationActionsBooleanFieldSchema - `type` 'BOOLEAN', required: Specifies the field type as BOOLEAN, indicating that the field can hold a true or false value. - AutomationActionsArrayFieldSchema - `items` object, required - `type` 'ARRAY', required: Specifies that the field is of type 'ARRAY'. - AutomationActionsObjectFieldSchema - `properties` object, required: Contains the properties of the object. - `type` 'OBJECT', required: Specifies the type of the field, which is 'OBJECT' by default. - `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 `definition/outputFields/items/typeDefinition/schema/oneOf[subschema #1: INTEGER]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `definition/outputFields/items/typeDefinition/schema/oneOf[subschema #2: LONG]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `definition/outputFields/items/typeDefinition/schema/oneOf[subschema #3: DOUBLE]/type` response property for the response status `200` - removed the `ARRAY` enum value from the `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/{revisionId}_getById` removed and replaced with `get-/automation/actions/2026-03/{appId}/{definitionId}/revisions/{revisionId}` - **2026-03-30** `dc2fdad57f7f`: 6 info - api tag `Revisions` added - api tag `Advanced` removed - the response property `definition/outputFields/items/typeDefinition/options/items/description` became required for the status `200` - the response property `definition/outputFields/items/typeDefinition/options/items/displayOrder` became required for the status `200` - …2 more - …earlier changes not shown [Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/automation/actions/2026-03/:appId/:definitionId/revisions/:revisionId/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)