Skip to main content

get-active-theme 

dci get-active-theme

Returns the theme currently active for the authenticated user. themeId is the reserved sentinel "default" when no custom or preset theme is selected and the user is on the built-in default.

Examples​

# Show the theme active for the authenticated user (`default` when no custom or preset theme is selected).
dci get-active-theme
# The active theme ID as JSON, for scripts.
dci get-active-theme --output json

Output​

OK - The request succeeded.

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

FieldTypeDescription
themeIdstringIdentifier of the active theme. The reserved sentinel "default" is returned when the user is using the built-in default (no custom or preset theme stored). Default: "default".
Raw JSON schema
{
  "type": "object",
  "required": [
    "themeId"
  ],
  "description": "The theme currently active for the authenticated user.",
  "properties": {
    "themeId": {
      "type": "string",
      "default": "default",
      "description": "Identifier of the active theme. The reserved sentinel `\"default\"` is\nreturned when the user is using the built-in default (no custom or\npreset theme stored)."
    }
  }
}

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 statusExit codeError codeMeaning
40110AUTHENTICATION_FAILEDNot signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
40311PERMISSION_DENIEDThe DoiT user or the active customer context does not have access.

Aliases: getactivetheme