Skip to main content

get-cloudflow-template

dci get-cloudflow-template templateId

Returns a single CloudFlow template by ID.

Output

OK

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

FieldTypeDescription
idstringUnique identifier of the template.
namestringHuman-readable display name of the template.
descriptionstringShort summary of what the template does and which use case it addresses.
instructionsstringStep-by-step operator guidance for configuring a flow created from this template. null when no instructions have been authored.
createTimestring (date-time)ISO 8601 (UTC) creation timestamp.
updateTimestring (date-time)ISO 8601 (UTC) last-modified timestamp. null if never modified.
Raw JSON schema
{
"type": "object",
"description": "A read-only CloudFlow template (blueprint). Use `POST /flows` with `templateId` to create a new flow initialised from this template.",
"required": [
"id",
"name",
"createTime"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of the template."
},
"name": {
"type": "string",
"description": "Human-readable display name of the template."
},
"description": {
"type": "string",
"description": "Short summary of what the template does and which use case it addresses."
},
"instructions": {
"type": "string",
"nullable": true,
"description": "Step-by-step operator guidance for configuring a flow created from this template. `null` when no instructions have been authored."
},
"createTime": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 (UTC) creation timestamp."
},
"updateTime": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": "ISO 8601 (UTC) last-modified timestamp. `null` if never modified."
}
}
}

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.
40420RESOURCE_NOT_FOUNDThe requested resource does not exist. Check the identifier argument.
50040API_SERVER_ERRORThe API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: getcloudflowtemplate