Admin Commands

Perform bulk user management operations across ACC🏗️ACCAutodesk's construction management platform.View in glossary/BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary accounts. These commands enable efficient onboarding, offboarding, and permission management at scale.

Note: Admin commands require 3-legged OAuth👤3-legged authUser-authorized authentication with browser login.View in glossary with account admin privileges. Run raps auth login first.

Commands Overview

User Commands

raps admin user add

Add a user to multiple projects with a specified role.

raps admin user add <ACCOUNT_ID> <EMAIL> --role <ROLE> [OPTIONS]

Arguments:

• ACCOUNT_ID - ACC/BIM🏛️BIMIntelligent 3D model-based design for buildings.View in glossary 360 account ID
• EMAIL - User email address to add

Options:

• --role <ROLE> - Role to assign (required)
  • account_admin, project_admin, project_manager, viewer
• --filter <REGEX> - Filter projects by name pattern
• --dry-run - Preview changes without executing
• --output <FORMAT> - Output format (json📋JSONStandard data interchange format.View in glossary, table)

Example:

$ raps admin user add "acc-123" "user@company.com" --role project_admin
Adding user to projects...
[████████████████████████████████████████] 100/100

Results:
┌──────────────┬───────┐
│ Status       │ Count │
├──────────────┼───────┤
│ Succeeded    │ 95    │
│ Skipped      │ 3     │
│ Failed       │ 2     │
└──────────────┴───────┘

raps admin user remove

Remove a user from multiple projects.

raps admin user remove <ACCOUNT_ID> <EMAIL> [OPTIONS]

Arguments:

• ACCOUNT_ID - ACC/BIM 360 account ID
• EMAIL - User email address to remove

Options:

• --filter <REGEX> - Filter projects by name pattern
• --dry-run - Preview changes without executing
• --output <FORMAT> - Output format

Example:

$ raps admin user remove "acc-123" "departed@company.com"
Removing user from projects...
[████████████████████████████████████████] 100/100

Results:
┌──────────────┬───────┐
│ Status       │ Count │
├──────────────┼───────┤
│ Succeeded    │ 45    │
│ Skipped      │ 55    │
└──────────────┴───────┘

raps admin user update-role

Update a user’s role across multiple projects.

raps admin user update-role <ACCOUNT_ID> <EMAIL> --role <ROLE> [OPTIONS]

Arguments:

• ACCOUNT_ID - ACC/BIM 360 account ID
• EMAIL - User email address

Options:

• --role <ROLE> - New role to assign (required)
• --filter <REGEX> - Filter projects by name pattern
• --dry-run - Preview changes without executing
• --output <FORMAT> - Output format

Example:

$ raps admin user update-role "acc-123" "user@company.com" --role viewer
Updating user role...
[████████████████████████████████████████] 50/50

Results:
┌──────────────┬───────┐
│ Status       │ Count │
├──────────────┼───────┤
│ Succeeded    │ 48    │
│ Skipped      │ 2     │
└──────────────┴───────┘

Folder Commands

raps admin folder rights

Update folder permissions for a user across multiple projects.

raps admin folder rights <ACCOUNT_ID> <EMAIL> --permission <LEVEL> --folder <TYPE> [OPTIONS]

Arguments:

• ACCOUNT_ID - ACC/BIM 360 account ID
• EMAIL - User email address

Options:

• --permission <LEVEL> - Permission level (required)
  • view, view_download, upload, edit, control
• --folder <TYPE> - Folder type (required)
  • project_files, plans, or folder URN🔗URNUnique identifier for objects in APS.View in glossary for custom
• --filter <REGEX> - Filter projects by name pattern
• --dry-run - Preview changes without executing
• --output <FORMAT> - Output format

Example:

$ raps admin folder rights "acc-123" "contractor@partner.com" \
    --permission edit --folder project_files
Updating folder permissions...
[████████████████████████████████████████] 75/75

Results:
┌──────────────┬───────┐
│ Status       │ Count │
├──────────────┼───────┤
│ Succeeded    │ 72    │
│ Failed       │ 3     │
└──────────────┴───────┘

Project Commands

raps admin project list

List projects in an account with optional filtering.

raps admin project list <ACCOUNT_ID> [OPTIONS]

Arguments:

• ACCOUNT_ID - ACC/BIM 360 account ID

Options:

• --filter <REGEX> - Filter by project📁ProjectContainer for folders and files within a hub.View in glossary name
• --status <STATUS> - Filter by status (active, archived, pending)
• --platform <PLATFORM> - Filter by platform (acc, bim360)
• --limit <N> - Limit number of results
• --output <FORMAT> - Output format

Example:

$ raps admin project list "acc-123" --status active --limit 5
Projects:
┌────────────────────────────────────────┬─────────────────────────┬─────────┬──────────┐
│ ID                                     │ Name                    │ Status  │ Platform │
├────────────────────────────────────────┼─────────────────────────┼─────────┼──────────┤
│ b.proj-001                             │ Downtown Tower          │ active  │ ACC      │
│ b.proj-002                             │ Hospital Wing           │ active  │ ACC      │
│ b.proj-003                             │ University Library      │ active  │ ACC      │
│ b.proj-004                             │ Retail Plaza            │ active  │ BIM360   │
│ b.proj-005                             │ Office Complex          │ active  │ ACC      │
└────────────────────────────────────────┴─────────────────────────┴─────────┴──────────┘

Operation Commands

raps admin operation status

View the status and progress of an operation.

raps admin operation status [OPTIONS]

Options:

• --id <UUID> - Specific operation ID (default: most recent)
• --output <FORMAT> - Output format

Example:

$ raps admin operation status
Operation: 550e8400-e29b-41d4-a716-446655440000
Type: AddUser
Status: InProgress

Progress:
[████████████████████░░░░░░░░░░░░░░░░░░░░] 50/100

Results so far:
┌──────────────┬───────┐
│ Status       │ Count │
├──────────────┼───────┤
│ Succeeded    │ 45    │
│ Skipped      │ 3     │
│ Failed       │ 2     │
│ Pending      │ 50    │
└──────────────┴───────┘

raps admin operation resume

Resume an interrupted operation.

raps admin operation resume [OPTIONS]

Options:

• --id <UUID> - Operation ID to resume (default: most recent in-progress)

Example:

$ raps admin operation resume
Resuming operation: 550e8400-e29b-41d4-a716-446655440000
Continuing from project 51 of 100...
[████████████████████████████████████████] 100/100

Operation completed successfully!

raps admin operation cancel

Cancel an in-progress operation.

raps admin operation cancel [OPTIONS]

Options:

• --id <UUID> - Operation ID to cancel (default: most recent in-progress)

Example:

$ raps admin operation cancel
Cancelling operation: 550e8400-e29b-41d4-a716-446655440000
Operation cancelled. 50 projects were processed before cancellation.

raps admin operation list

List all operations with optional filtering.

raps admin operation list [OPTIONS]

Options:

• --status <STATUS> - Filter by status (pending, in_progress, completed, failed, cancelled)
• --limit <N> - Limit results
• --output <FORMAT> - Output format

Example:

$ raps admin operation list
Operations:
┌──────────────────────────────────────┬────────────┬─────────────┬───────┬─────────┬────────┐
│ ID                                   │ Type       │ Status      │ Total │ Success │ Failed │
├──────────────────────────────────────┼────────────┼─────────────┼───────┼─────────┼────────┤
│ 550e8400-e29b-41d4-a716-446655440000 │ AddUser    │ Completed   │ 100   │ 95      │ 2      │
│ 661f9511-f3ac-52e5-b827-557766551111 │ RemoveUser │ InProgress  │ 50    │ 25      │ 0      │
│ 772a0622-a4bd-63f6-c938-668877662222 │ UpdateRole │ Cancelled   │ 75    │ 30      │ 1      │
└──────────────────────────────────────┴────────────┴─────────────┴───────┴─────────┴────────┘

Common Workflows

Onboard New Team Member

# 1. Preview what projects will be affected
raps admin user add "$ACCOUNT_ID" "new@company.com" \
  --role project_admin --dry-run

# 2. Add user to all projects
raps admin user add "$ACCOUNT_ID" "new@company.com" \
  --role project_admin

# 3. Grant folder permissions
raps admin folder rights "$ACCOUNT_ID" "new@company.com" \
  --permission edit --folder project_files

Offboard Departing Employee

# 1. Remove from all projects
raps admin user remove "$ACCOUNT_ID" "departed@company.com"

# 2. Verify removal
raps admin operation status

Bulk Role Update

# Update all viewers to project_admin on active 2024 projects
raps admin user update-role "$ACCOUNT_ID" "user@company.com" \
  --role project_admin --filter "^2024-"

Exit Codes

Next Steps

• Account Admin Cookbook - Detailed recipes and automation🤖AutomationReplacing manual processes with software.View in glossary
• Data Management - Browse hubs and projects
• Authentication - Configure OAuth🔐OAuthIndustry-standard authorization protocol used by APS.View in glossary