Data Management Commands

Browse hubs, projects, folders, and items in BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary and Autodesk Construction Cloud🏗️ACCAutodesk's construction management platform.View in glossary (ACC).

Note: Data Management📂Data ManagementAPS service for accessing files in ACC, BIM 360, and Fusion.View in glossary commands require 3-legged OAuth👤3-legged authUser-authorized authentication with browser login.View in glossary. Run raps auth login first.

Commands Overview

raps hub list

List all accessible BIM🏛️BIMIntelligent 3D model-based design for buildings.View in glossary 360/ACC hubs.

$ raps hub list
Hubs:
┌──────────────────────────────────────────┬─────────────────────────────┬───────┐
│ ID                                       │ Name                        │ Type  │
├──────────────────────────────────────────┼─────────────────────────────┼───────┤
│ b.12345678-1234-1234-1234-123456789abc   │ My Company                  │ BIM360│
│ b.87654321-4321-4321-4321-cba987654321   │ Partner Organization        │ ACC   │
└──────────────────────────────────────────┴─────────────────────────────┴───────┘

raps project list

List projects within a hub.

$ raps project list b.12345678-1234-1234-1234-123456789abc
Projects in 'My Company':
┌────────────────────────────────────────┬─────────────────────────────────┐
│ ID                                     │ Name                            │
├────────────────────────────────────────┼─────────────────────────────────┤
│ b.proj-123                             │ Downtown Office Building        │
│ b.proj-456                             │ Hospital Renovation             │
│ b.proj-789                             │ University Campus               │
└────────────────────────────────────────┴─────────────────────────────────┘

raps folder list

List contents of a folder.

$ raps folder list b.proj-123 urn:adsk.wipprod:fs.folder:abc123
Folder Contents:
┌─────────┬────────────────────────────────┬───────────────────────────────┐
│ Type    │ Name                           │ ID                            │
├─────────┼────────────────────────────────┼───────────────────────────────┤
│ folder  │ Drawings                       │ urn:adsk...folder:def456      │
│ folder  │ Models                         │ urn:adsk...folder:ghi789      │
│ item    │ Project Schedule.xlsx          │ urn:adsk...item:jkl012        │
└─────────┴────────────────────────────────┴───────────────────────────────┘

List top-level folders:

raps folder list b.proj-123 --top

raps folder create

Create a new folder.

$ raps folder create b.proj-123 urn:adsk...folder:parent --name "New Folder"
✓ Folder created successfully!
  Name: New Folder
  ID: urn:adsk.wipprod:fs.folder:xyz789

raps folder rename

Rename a folder.

raps folder rename <PROJECT_ID> <FOLDER_ID> --name <NEW_NAME>

Example:

$ raps folder rename b.proj-123 urn:adsk...folder:abc123 --name "Revised Drawings"
✓ Folder renamed successfully!

raps folder delete

Delete a folder.

raps folder delete <PROJECT_ID> <FOLDER_ID>

Warning: Folder must be empty. Move or delete contents first.

Example:

$ raps folder delete b.proj-123 urn:adsk...folder:abc123
✓ Folder deleted successfully!

raps item versions

List all versions of an item.

$ raps item versions urn:adsk.wipprod:dm.lineage:abc123
Versions of 'Building Model.rvt':
┌─────────┬─────────────────────────┬────────────────────────────────────────┐
│ Version │ Created                 │ URN                                    │
├─────────┼─────────────────────────┼────────────────────────────────────────┤
│ 3       │ 2024-01-15 14:30:00     │ urn:adsk.wipprod:fs.file:version3      │
│ 2       │ 2024-01-10 09:15:00     │ urn:adsk.wipprod:fs.file:version2      │
│ 1       │ 2024-01-05 11:00:00     │ urn:adsk.wipprod:fs.file:version1      │
└─────────┴─────────────────────────┴────────────────────────────────────────┘

raps item delete

Delete an item from a project.

raps item delete <PROJECT_ID> <ITEM_ID>

Example:

$ raps item delete b.proj-123 urn:adsk.wipprod:dm.lineage:abc123
✓ Item deleted successfully

raps item rename

Rename an item (update display name).

raps item rename <PROJECT_ID> <ITEM_ID> --name <NEW_NAME>

Options:

• --name, -n - New display name

Example:

$ raps item rename b.proj-123 urn:adsk.wipprod:dm.lineage:abc123 --name "Updated Model v2.rvt"
✓ Item renamed to: Updated Model v2.rvt

Common Workflows

Browse project structure

# 1. List hubs
raps hub list

# 2. List projects in a hub
raps project list b.12345678-1234-1234-1234-123456789abc

# 3. List top-level folders
raps folder list b.proj-123 --top

# 4. Browse specific folder
raps folder list b.proj-123 urn:adsk.wipprod:fs.folder:abc123

Export project data

# Export all hubs as JSON
raps hub list --output json > hubs.json

# Export projects
raps project list $HUB_ID --output json > projects.json

Next Steps

• Issues — Manage project issues
• Webhooks — Subscribe to project events