topic Re: Create / Modify Revit Scope Boxes through API in Revit API Forum

Create / Modify Revit Scope Boxes through API

jnoordzij — Wed, 22 Mar 2023 08:17:12 GMT

Hi, I was searching for an API way of creating / modifying Revit scope boxes. But I did not find any results in the Revit API docs. Also on the Dynamo forum, there is this old post from 2015 saying that it is not possible through the API. Is this still the case? Isnt there any API functionality to create / duplicate / modify scope boxes?

https://forum.dynamobim.com/t/creating-scope-boxes-with-dynamo-possible-or-not/1962/6

Re: Create / Modify Revit Scope Boxes through API

moturi.magati.george — Wed, 22 Mar 2023 09:15:43 GMT

Hi @jnoordzij,

This was a response from the engineering team on a similar question.

"Unfortunately, Scope boxes cannot be created in the API yet, but you can read data from them and they can be used to generate filters used for object selection."

You can have a look at this forum thread and see the suggestion if it will help you.

https://forums.autodesk.com/t5/revit-api-forum/create-scope-boxes/td-p/7050125

Whenever you require new or enhanced functionality, the Revit Idea Station is the place to go.

Please search there for a corresponding wish list entry for the suggested functionality and add your comments to it, or create a new one, if none already exists:

https://forums.autodesk.com/t5/revit-ideas/idb-p/302

Tag it as an API wish:

https://forums.autodesk.com/t5/revit-ideas/idb-p/302/tab/most-recent/label-name/api

Ensure it gets as many votes as possible to underline its importance to you and the rest of the developer community.

The Revit Idea Station is currently one of the main driving input forces for Revit API enhancements.

The Revit development team look there. Your comment here in the discussion forum might be overlooked.

Re: Create / Modify Revit Scope Boxes through API

jnoordzij — Thu, 30 Mar 2023 06:57:04 GMT

Thanks for the info! I found that even though scopebox creation is impossible, it is possible to duplicate another scopebox and modify its parameters like its position, lenght, width, height, name, etcetera. This way I was able to create new scope boxes from a dummy scope box, and modifying them to meet all my wishes.

Re: Create / Modify Revit Scope Boxes through API

moturi.magati.george — Thu, 30 Mar 2023 07:15:04 GMT

Hi @jnoordzij,

I am glad you found a workaround for your problem.
Cheers

Re: Create / Modify Revit Scope Boxes through API

official.jaydeo — Tue, 25 Jul 2023 12:36:02 GMT

Can you show us how to filter scopebox and modify? also can we duplicate scope box?

Re: Create / Modify Revit Scope Boxes through API

pieterschiettecatte — Wed, 28 Aug 2024 19:05:24 GMT

I'm really curious how you were able to edit the width and length of an existing scope box. The selection is easy:

FilteredElementCollector collector = new FilteredElementCollector(Document) .OfCategory(BuiltInCategory.OST_VolumeOfInterest) .WhereElementIsNotElementType();

But how to adjust the scope box dimensions? Height seems to be an exposed parameter. but length and width are not exposed?

Re: Create / Modify Revit Scope Boxes through API

jnoordzij — Wed, 28 Aug 2024 20:09:50 GMT

I don't remember which project I used this technique for so I can't look it up. But the first that comes to my mind is to use Dynamo to select a scopebox element and query its parameters. See if there are parameters there like width, length, position and if you can modify them (or maybe its a boundary parameter, I dont remember). I think thats the way I did it. If it's possible through Dynamo it should be possible through the Revit API.

Re: Create / Modify Revit Scope Boxes through API

jnoordzij — Wed, 28 Aug 2024 20:06:20 GMT

I think I duplicated the scopebox element with a Dynamo node

Re: Create / Modify Revit Scope Boxes through API

pieterschiettecatte — Thu, 29 Aug 2024 10:31:15 GMT

Duplicating scope boxes is a good workaround for not being able to create them, but I think most use cases will require to be able to edit their width and depth, not just the height.

Height, Position and Name are exposed in Revit 2025, but there does not seem to be a way to edit width or depth. Are you sure you were able to edit these parameters?

Re: Create / Modify Revit Scope Boxes through API

marcusss_ — Thu, 13 Mar 2025 20:05:27 GMT

Does anyone know the answer, can we adjust scope boxes via API, or no?

Re: Create / Modify Revit Scope Boxes through API

rcrdzmmrmnn — Thu, 13 Mar 2025 20:21:35 GMT

I don’t think so. Scope boxes don’t even have their own class; they belong to the Element class. They also don’t have parameters like width and length. So, unless a subclass like ScopeBox is introduced and given a property to define its boundaries using BoundingBoxXYZ, I don’t believe this will be possible.

Re: Create / Modify Revit Scope Boxes through API

rcrdzmmrmnn — Thu, 13 Mar 2025 20:28:06 GMT

I've created an idea in the Revit Ideas forum. Vote and give more suggestions there please.
Create Subclass for ScopeBox with a Constructor of ScopeBox(BoundingBoxXYZ) - Autodesk Community

Re: Create / Modify Revit Scope Boxes through API

pieterschiettecatte — Thu, 13 Mar 2025 20:52:23 GMT

fwiw, there already is a Revit idea about editing scope boxes through the API with 99 votes: https://forums.autodesk.com/t5/revit-ideas/scope-boxes-control-visibility-amp-size-via-api/idi-p/8020269

Re: Create / Modify Revit Scope Boxes through API

rcrdzmmrmnn — Thu, 13 Mar 2025 20:57:02 GMT

Oh, I didn't know that, and couldn't find a way to delete the post, so I've edited it and added a link to this idea.
Thank you for pointing out @pieterschiettecatte

Re: Create / Modify Revit Scope Boxes through API

jnoordzij — Fri, 14 Mar 2025 08:34:17 GMT

Was thinking back about it and maybe what I did back then was to duplicate, move, and rotate an existing scopebox element into desired new position with dynamo nodes Element,Duplicate, Element.Move and Element.Rotate. But I'm not sure.

Re: Create / Modify Revit Scope Boxes through API

ning_zhouHNQLJ — Tue, 09 Sep 2025 16:59:12 GMT

just wonder how you can change scope box length and width? seems only height parameter available.