--- title: "Retrieve a specific revision of a definition" method: GET path: "/automation/actions/2026-09/{appId}/{definitionId}/revisions/{revisionId}" tags: ["Revisions"] --- # Retrieve a specific revision of a definition `GET /automation/actions/2026-09/{appId}/{definitionId}/revisions/{revisionId}` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}/revisions/{revisionId}` - Auth: API key in query parameter `hapikey` 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 - PublicActionRevision - `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 - `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. - LongFieldSchema - `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. - DoubleFieldSchema - `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. - StringFieldSchema - `format` 'DATE' | 'DATE_TIME' | 'MONTH_AND_DAY' | 'OBJECT_COORDINATE' | 'OBJECT_TYPE' | '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. - BooleanFieldSchema - `type` 'BOOLEAN', required: Specifies the field type as BOOLEAN, indicating that the field can hold a true or false value. - ArrayFieldSchema - `items` union, required: Defines the type of elements contained within the array, which can be an integer, long, double, string, boolean, another array, or an object. - … - `type` 'ARRAY', required: Specifies that the field is of type 'ARRAY'. - ObjectFieldSchema - `properties` object, required: Contains the properties of the object. - `type` 'OBJECT', required: Specifies the type of the field, which is 'OBJECT' by default. - UnknownFieldSchema - `type` 'UNKNOWN', required: A string that indicates the type of the field. In this schema, it is always set to 'UNKNOWN'. - `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 `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 `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 `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 `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/:revisionId/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)