APS Automation API - Update Revit Titleblocks

---

🚀 Overview

Update Revit Titleblocks is a .NET 8 solution designed to automate the process of updating title blocks in Autodesk Revit projects.

This project was created to demonstrate APS Automation API capabilities as presented in Autodesk University 2025 session 3136, "Moving from Revit API Add-Ins to the Design Automation API: A Beginner’s Guide."
Learn more at: AU2025 Session 3136

---

📦 Solution Projects

RevitAutomationUpdateTitleblocks

This is a Revit Add-in project designed to work with the Autodesk Design Automation API. It contains the core logic for updating title blocks in Revit files and is intended to be executed in the cloud via the Design Automation service. The add-in is packaged and uploaded as a bundle for remote execution.

LocalDebug

This project is designed to enable local testing and debugging of the RevitAutomationUpdateTitleblocks add-in. It provides a local harness to simulate the Design Automation environment, allowing you to run and debug the add-in directly within Visual Studio and Revit, without deploying to the cloud.

---

🛠️ Prerequisites

• Windows 10/11
• .NET 8 SDK
  Download .NET 8 SDK
• Visual Studio 2022 (recommended)
  Download Visual Studio 2022
• Autodesk Revit 2025
• (Optional) Git for source control

---

⚙️ Building the Solution

1. Clone the repository:

• git clone https://github.com/nseirs/revit-automation-update-titleblocks.git cd revit-automation-update-titleblocks

2. Open the solution in Visual Studio 2022:

• Double-click the .sln file or open it via File > Open > Project/Solution.

3. Restore NuGet packages:

• Visual Studio will prompt you, or right-click the solution and select Restore NuGet Packages.

4. Build the solution:

• Press Ctrl+Shift+B or select Build > Build Solution.

---

🐞 Debugging

1. Set your startup project:

• Right-click the desired project in Solution Explorer and select Set as Startup Project.

2. Configure debugging options (if needed):

• Go to Project > Properties > Debug to set command-line arguments or environment variables.

3. Start debugging:

• Press F5 or select Debug > Start Debugging.

---

📬 Using the Postman Collection

This solution includes a Postman collection and environment to help you test and interact with APS API endpoints.

1. Import the Postman Collection and Environment

• Open Postman.
• Click Import in the top left.
• Select the provided .postman_collection.json and .postman_environment.json files from the repository (typically found in the postman/ or docs/ folder).

2. Configure the Environment

• In Postman, go to the Environments tab.
• Select the imported environment (e.g., AU2025 - Revit Automation).
• Update variables as needed.
• Any other variables specific to your deployment.

3. Run Requests

• Select the imported environment from the environment dropdown (top right).
• Open the collection and expand to see available requests.
• Click on a request, review/edit parameters if needed, and click Send.
• Review the response in the lower panel.

---

📄 License

This project is licensed under the MIT License.

---

✍️ Written By

• Sam Nseir (@samnseir)
• Mark Rocha (@markrocha)
• Zach Smith (@zachsmith)

---