Hubspot Custom Workflow Actions Action Definition Revision Collection Structure

{
  "type": "object",
  "description": "A paginated collection of action definition revisions",
  "name": "ActionDefinitionRevisionCollection",
  "properties": {
    "results": {
      "type": "array",
      "description": "List of revisions",
      "items": {
        "type": "object",
        "description": "A revision of an action definition",
        "properties": {
          "revisionId": {
            "type": "string",
            "description": "The unique identifier of the revision"
          },
          "definition": {
            "type": "object",
            "description": "A custom workflow action definition",
            "properties": {
              "id": {
                "type": "string",
                "description": "The unique identifier of the action definition"
              },
              "revisionId": {
                "type": "string",
                "description": "The current revision identifier"
              },
              "actionUrl": {
                "type": "uri",
                "description": "The URL that HubSpot will call when the action executes"
              },
              "labels": {
                "type": "object",
                "description": "Human-readable labels for the action",
                "properties": {
                  "actionName": {
                    "type": "string",
                    "description": "The display name of the action"
                  },
                  "actionDescription": {
                    "type": "string",
                    "description": "A description of what the action does"
                  },
                  "appDisplayName": {
                    "type": "string",
                    "description": "The name of the app providing this action"
                  },
                  "actionCardContent": {
                    "type": "string",
                    "description": "Content to display on the action card in the workflow editor"
                  }
                },
                "required": [
                  "actionName"
                ]
              },
              "inputFields": {
                "type": "array",
                "description": "Input fields that users can configure for the action",
                "items": {
                  "type": "object",
                  "description": "An input field for the action",
                  "properties": {
                    "typeDefinition": {
                      "type": "object"
                    },
                    "supportedValueTypes": {
                      "type": "object"
                    },
                    "isRequired": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "typeDefinition",
                    "supportedValueTypes"
                  ]
                }
              },
              "outputFields": {
                "type": "array",
                "description": "Output fields that the action returns",
                "items": {
                  "type": "object",
                  "description": "An output field returned by the action",
                  "properties": {
                    "typeDefinition": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "typeDefinition"
                  ]
                }
              },
              "objectTypes": {
                "type": "array",
                "description": "CRM object types this action can operate on",
                "items": {
                  "type": "string",
                  "enum": [
                    "CONTACT",
                    "COMPANY",
                    "DEAL",
                    "TICKET",
                    "QUOTE"
                  ]
                }
              },
              "objectRequestOptions": {
                "type": "object",
                "description": "Options for requesting CRM object data",
                "properties": {
                  "properties": {
                    "type": "array",
                    "description": "CRM properties to include in the action execution request",
                    "items": {
                      "type": "object"
                    }
                  }
                }
              },
              "published": {
                "type": "boolean",
                "description": "Whether the action is published and available for use"
              },
              "functions": {
                "type": "array",
                "description": "Functions associated with this action",
                "items": {
                  "type": "object",
                  "description": "A reference to a function associated with an action",
                  "properties": {
                    "functionType": {
                      "type": "object"
                    },
                    "id": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "functionType",
                    "id"
                  ]
                }
              }
            },
            "required": [
              "id",
              "revisionId",
              "actionUrl",
              "labels",
              "objectTypes"
            ]
          },
          "createdAt": {
            "type": "datetime",
            "description": "When the revision was created"
          }
        },
        "required": [
          "revisionId",
          "definition",
          "createdAt"
        ]
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information",
      "properties": {
        "next": {
          "type": "object",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor for the next page"
            }
          }
        }
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-structure.org/draft/2020-12/schema"
}