Issue Commands

Create, track, and manage issues in ACC (Autodesk Construction Cloud) and BIM 360 projects.

Note: Issue commands require 3-legged OAuth with project access. Run raps auth login first.

Commands Overview

CommandDescription
raps issue listList issues in a project
raps issue createCreate a new issue
raps issue updateUpdate an issue
raps issue typesList issue types/categories
raps issue commentManage issue comments
raps issue attachmentsList issue attachments
raps issue transitionTransition issue status
raps issue deleteDelete an issue

raps issue list

List issues in a project with optional filtering.

raps issue list [OPTIONS] <PROJECT_ID>

Arguments:

  • <PROJECT_ID> β€” Project ID (without b. prefix)

Options:

  • -s, --status <STATUS> β€” Filter by status (open, closed, etc.)
  • --since <SINCE> β€” Only show issues created after this date (YYYY-MM-DD)

Example:

$ raps issue list my-project-id
$ raps issue list my-project-id --status open --output json
$ raps issue list my-project-id --since "2026-01-01"

raps issue create

Create a new issue or bulk-create from a CSV file.

raps issue create [OPTIONS] <PROJECT_ID>

Options:

  • -t, --title <TITLE> β€” Issue title
  • -d, --description <DESCRIPTION> β€” Issue description
  • --from-csv <FILE> β€” Create issues from CSV (columns: title, description, status)

Example:

$ raps issue create my-project-id -t "Clash at grid A-3" -d "Structural clash detected"
$ raps issue create my-project-id --from-csv issues.csv

raps issue update

Update an existing issue.

raps issue update <PROJECT_ID> <ISSUE_ID> [OPTIONS]

raps issue types

List available issue types (categories) for a project.

raps issue types <PROJECT_ID> [--output FORMAT]

raps issue comment

Manage comments on issues. Subcommands: add, list.

raps issue comment add <PROJECT_ID> <ISSUE_ID> -b "Comment text"
raps issue comment list <PROJECT_ID> <ISSUE_ID>

Example:

$ raps issue comment add my-project demo-issue-001 -b "See model view at Level 2"

raps issue attachments

List attachments for an issue.

raps issue attachments <PROJECT_ID> <ISSUE_ID>

raps issue transition

Transition an issue to a new status.

raps issue transition <PROJECT_ID> <ISSUE_ID> --status <STATUS>

raps issue delete

Delete an issue.

raps issue delete <PROJECT_ID> <ISSUE_ID>

Next Steps