Skip to main content

list-products

dci list-products [flags]

Returns a list of all the available products of specific platforms.

Flags

--platform: (string)

Output

OK - List of available products returned.

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

FieldTypeDescription
productsarray of object
products[].displayNamestring
products[].idstring
products[].platformstring
Raw JSON schema
{
"type": "object",
"properties": {
"products": {
"type": "array",
"items": {
"type": "object",
"description": "Platform/product metadata used by product listing endpoints.",
"properties": {
"displayName": {
"type": "string"
},
"id": {
"type": "string"
},
"platform": {
"type": "string"
}
}
}
}
}
}

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 statusExit codeError codeMeaning
40030VALIDATION_ERRORThe arguments or request body were rejected. Review the command's flags and payload.
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: listproducts