get-cloud-diagrams-stats

dci get-cloud-diagrams-stats [flags]

Returns a list of all diagrams with activity stats for the given time period.

Examples

# Every diagram with its cloud account, import status, and change counts.
dci get-cloud-diagrams-stats

# Activity stats for August 2026 (RFC 3339 timestamps).
dci get-cloud-diagrams-stats --start 2026-08-01T00:00:00Z --end 2026-09-01T00:00:00Z

# As JSON, e.g. to pick the `ss_id` (layer ID) that the other cloud-diagram commands take.
dci get-cloud-diagrams-stats --output json

Flags

Flag	Type	Default	Example	Description
--start	string (date-time)		2026-04-01T00:00:00Z	Start of the period.
--end	string (date-time)		2026-04-28T00:00:00Z	End of the period.

Every command also accepts the CLI-wide flags for output shaping — see Output formats and Table output options.

Output

OK - List of diagrams with stats returned.

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

Field	Type	Description
[]._id	string	ID of the diagram.
[].ss_id	string	ID of the layer the diagram belongs to.
[].name	string	Name of the diagram.
[].type	string	Type of the diagram. One of: "application", "infrastructure", "network", "template".
[].account_name	string	Cloud account name.
[].account_id	string	Cloud account ID.
[].account_type	string	Cloud account type.
[].changes	array of object	Activity changes within the period.
[].changes[].type	string	Type of the change. One of: "NODE_CREATE", "NODE_UPDATE", "NODE_DELETE".
[].changes[].service	string	Cloud service the change applies to.
[].changes[].count	integer	Number of occurrences of this change type.
[].import	object	Current import/sync state for a cloud-connected diagram.
[].import.status	string	Import status. One of: "queued", "in_progress", "success", "failure".
[].import.type	string	Connected cloud account type. One of: "AWS", "GCP", "AZURE".
[].import.account	string	Connected account ID.
[].import.cloudId	string	Cloud account ID.
[].import.errorMessage	string	Error message if the import failed.
[].import.syncedAt	string (date-time)	Timestamp of the last successful sync.

Raw JSON schema

{
  "type": "array",
  "items": {
    "type": "object",
    "description": "Diagram with activity stats for a given time period.",
    "properties": {
      "_id": {
        "type": "string",
        "description": "ID of the diagram."
      },
      "ss_id": {
        "type": "string",
        "description": "ID of the layer the diagram belongs to."
      },
      "name": {
        "type": "string",
        "description": "Name of the diagram."
      },
      "type": {
        "type": "string",
        "enum": [
          "application",
          "infrastructure",
          "network",
          "template"
        ],
        "description": "Type of the diagram."
      },
      "account_name": {
        "type": "string",
        "description": "Cloud account name."
      },
      "account_id": {
        "type": "string",
        "description": "Cloud account ID."
      },
      "account_type": {
        "type": "string",
        "description": "Cloud account type."
      },
      "changes": {
        "type": "array",
        "description": "Activity changes within the period.",
        "items": {
          "type": "object",
          "description": "A single activity change entry in a diagram stats record.",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "NODE_CREATE",
                "NODE_UPDATE",
                "NODE_DELETE"
              ],
              "description": "Type of the change."
            },
            "service": {
              "type": "string",
              "description": "Cloud service the change applies to."
            },
            "count": {
              "type": "integer",
              "description": "Number of occurrences of this change type."
            }
          }
        }
      },
      "import": {
        "type": "object",
        "description": "Current import/sync state for a cloud-connected diagram.",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "in_progress",
              "success",
              "failure"
            ],
            "description": "Import status."
          },
          "type": {
            "type": "string",
            "enum": [
              "AWS",
              "GCP",
              "AZURE"
            ],
            "description": "Connected cloud account type."
          },
          "account": {
            "type": "string",
            "description": "Connected account ID."
          },
          "cloudId": {
            "type": "string",
            "description": "Cloud account ID."
          },
          "errorMessage": {
            "type": "string",
            "description": "Error message if the import failed."
          },
          "syncedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of the last successful sync."
          }
        }
      }
    }
  }
}

Errors

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP status to exit code mapping

HTTP status	Exit code	Error code	Meaning
400	30	VALIDATION_ERROR	The arguments or request body were rejected. Review the command's flags and payload.
401	10	AUTHENTICATION_FAILED	Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
403	11	PERMISSION_DENIED	The DoiT user or the active customer context does not have access.

Related

• get-cloud-diagram-components — Get diagram components
• list-cloud-diagram-activity-groups — List activity groups for a layer
• get-cloud-diagram-cost-snapshot — Get diagram cost snapshot
• API reference: GET /clouddiagrams/v1/scheme/stats

Aliases: getclouddiagramsstats