hasura · robertjdominguez · Aug 12, 2025 · Aug 12, 2025
diff --git a/docs/reference/cli/commands/ddn.mdx b/docs/reference/cli/commands/ddn.mdx
@@ -50,6 +50,7 @@ ddn [flags]
 - [ddn model](/reference/cli/commands/ddn_model) - Perform Model-related operations
 - [ddn plugins](/reference/cli/commands/ddn_plugins) - Manage plugins for the CLI
 - [ddn project](/reference/cli/commands/ddn_project) - Manage Hasura DDN Project
+- [ddn promptql-program](/reference/cli/commands/ddn_promptql-program) - Perform PromptQL program (Automations) related operations
 - [ddn relationship](/reference/cli/commands/ddn_relationship) - Perform Relationship related operations
 - [ddn run](/reference/cli/commands/ddn_run) - Run specific script from project's context config
 - [ddn subgraph](/reference/cli/commands/ddn_subgraph) - Perform Subgraph-related operations

diff --git a/docs/reference/cli/commands/ddn_context_get.mdx b/docs/reference/cli/commands/ddn_context_get.mdx
@@ -20,7 +20,7 @@ Get the value of a key in the context.
 Get the value of a key in the context
 
 ```bash
-ddn context get <key> (Allowed keys: cloudEnvFile, selfHostedDataPlane, noBuildConnectors, project, supergraph, subgraph, localEnvFile) [flags]
+ddn context get <key> (Allowed keys: supergraph, subgraph, localEnvFile, cloudEnvFile, selfHostedDataPlane, noBuildConnectors, project) [flags]
 ```
 
 ## Examples

diff --git a/docs/reference/cli/commands/ddn_context_unset.mdx b/docs/reference/cli/commands/ddn_context_unset.mdx
@@ -20,7 +20,7 @@ Unset the value of a key in the context.
 Unset the value of a key in the context
 
 ```bash
-ddn context unset <key> (Allowed keys: selfHostedDataPlane, noBuildConnectors, project, supergraph, subgraph, localEnvFile, cloudEnvFile) [flags]
+ddn context unset <key> (Allowed keys: project, supergraph, subgraph, localEnvFile, cloudEnvFile, selfHostedDataPlane, noBuildConnectors) [flags]
 ```
 
 ## Examples

diff --git a/docs/reference/cli/commands/ddn_promptql-program.mdx b/docs/reference/cli/commands/ddn_promptql-program.mdx
@@ -0,0 +1,45 @@
+---
+sidebar_label: ddn promptql-program
+sidebar_position: 84
+description: Perform PromptQL program (Automations) related operations using the DDN CLI
+canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_promptql-program"
+keywords:
+  - hasura
+  - DDN
+  - docs
+  - CLI
+  - ddn promptql-program
+---
+
+# DDN CLI: ddn promptql-program
+
+Perform PromptQL program (Automations) related operations.
+
+## Synopsis
+
+Perform PromptQL program (Automations) related operations
+
+**Alias:** promptql-programs, pp
+
+## Available operations
+
+- [ddn promptql-program add](/reference/cli/commands/ddn_promptql-program_add) - Add a new PromptQL program
+
+## Options
+
+```sass
+-h, --help   help for promptql-program
+```
+
+## Options inherited from parent operations
+
+```sass
+--log-level string   Log level. Can be DEBUG, WARN, INFO, ERROR, or FATAL. (default "INFO")
+--no-prompt          Do not prompt for required but missing flags
+--out string         Output format. Can be table, json or yaml. (default "table")
+--timeout int        Request timeout in seconds [env: HASURA_DDN_TIMEOUT] (default 100)
+```
+
+## Parent operation
+
+- [ddn](/reference/cli/commands/ddn) - DDN Command Line Interface
diff --git a/docs/reference/cli/commands/ddn_promptql-program_add.mdx b/docs/reference/cli/commands/ddn_promptql-program_add.mdx
@@ -0,0 +1,63 @@
+---
+sidebar_label: ddn promptql-program add
+sidebar_position: 85
+description: Add a new PromptQL program using the DDN CLI
+canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_promptql-program_add"
+keywords:
+  - hasura
+  - DDN
+  - docs
+  - CLI
+  - ddn promptql-program add
+---
+
+# DDN CLI: ddn promptql-program add
+
+Add a new PromptQL program.
+
+## Synopsis
+
+Add a new PromptQL program
+
+```bash
+ddn promptql-program add [name] [flags]
+```
+
+## Examples
+
+```bash
+# Add an empty program to iterate on
+ ddn promptql-programs add sum_numbers
+
+# Initialize a program from a JSON artifact file
+ ddn promptql-programs add --from-artifact <path-to-program-json-file>
+```
+
+## Options
+
+```sass
+    --add-env stringArray            Environment variable to be set in the Programs Connector. Can be repeated to provide multiple env vars
+    --ci                             Disables the use of context
+    --connector string               Path to Connector YAML config file
+-c, --context string                 Name of the context to use. (default <current_context>)
+    --forward-header stringArray     HTTP headers to be forwarded to the Programs Connector. Can be repeated to provide multiple headers
+    --from-artifact string           Path to a JSON artifact used to create the program
+-h, --help                           help for add
+    --subgraph string                Path to Subgraph config file
+    --supergraph string              Path to Supergraph config file
+    --target-cloud-env-file string   Path to the cloud environment file
+    --target-local-env-file string   Path to the local environment file
+```
+
+## Options inherited from parent operations
+
+```sass
+--log-level string   Log level. Can be DEBUG, WARN, INFO, ERROR, or FATAL. (default "INFO")
+--no-prompt          Do not prompt for required but missing flags
+--out string         Output format. Can be table, json or yaml. (default "table")
+--timeout int        Request timeout in seconds [env: HASURA_DDN_TIMEOUT] (default 100)
+```
+
+## Parent operation
+
+- [ddn promptql-program](/reference/cli/commands/ddn_promptql-program) - Perform PromptQL program (Automations) related operations
diff --git a/docs/reference/cli/commands/ddn_relationship.mdx b/docs/reference/cli/commands/ddn_relationship.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn relationship
-sidebar_position: 84
+sidebar_position: 86
 description: Perform Relationship related operations using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_relationship"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_relationship_add.mdx b/docs/reference/cli/commands/ddn_relationship_add.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn relationship add
-sidebar_position: 85
+sidebar_position: 87
 description: Adds Relationships from foreign keys on collection-name or targeting collection-name using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_relationship_add"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_relationship_list.mdx b/docs/reference/cli/commands/ddn_relationship_list.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn relationship list
-sidebar_position: 86
+sidebar_position: 88
 description: Lists Relationships for a given DataConnectorLink using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_relationship_list"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_run.mdx b/docs/reference/cli/commands/ddn_run.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn run
-sidebar_position: 87
+sidebar_position: 89
 description: Run specific script from project's context config using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_run"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph.mdx b/docs/reference/cli/commands/ddn_subgraph.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph
-sidebar_position: 88
+sidebar_position: 90
 description: Perform Subgraph-related operations using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_add.mdx b/docs/reference/cli/commands/ddn_subgraph_add.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph add
-sidebar_position: 89
+sidebar_position: 91
 description: Add a Subgraph config file to Supergraph config file using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_add"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_build.mdx b/docs/reference/cli/commands/ddn_subgraph_build.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph build
-sidebar_position: 90
+sidebar_position: 92
 description: Perform SubgraphBuild-related operations using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_build"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_build_apply.mdx b/docs/reference/cli/commands/ddn_subgraph_build_apply.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph build apply
-sidebar_position: 91
+sidebar_position: 93
 description: Apply a Subgraph build on Hasura DDN using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_build_apply"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_build_create.mdx b/docs/reference/cli/commands/ddn_subgraph_build_create.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph build create
-sidebar_position: 92
+sidebar_position: 94
 description: Create a SubgraphBuild on Hasura DDN using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_build_create"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_build_get.mdx b/docs/reference/cli/commands/ddn_subgraph_build_get.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph build get
-sidebar_position: 93
+sidebar_position: 95
 description: List SubgraphBuilds or get details of a specific one using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_build_get"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_delete.mdx b/docs/reference/cli/commands/ddn_subgraph_delete.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph delete
-sidebar_position: 94
+sidebar_position: 96
 description: Delete a Subgraph, its corresponding Connectors and all its associated metadata objects from local project metadata using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_delete"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_subgraph_init.mdx b/docs/reference/cli/commands/ddn_subgraph_init.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn subgraph init
-sidebar_position: 95
+sidebar_position: 97
 description: Initialize a new Subgraph in local metadata using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_subgraph_init"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph.mdx b/docs/reference/cli/commands/ddn_supergraph.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph
-sidebar_position: 96
+sidebar_position: 98
 description: Perform Supergraph-related operations using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build.mdx b/docs/reference/cli/commands/ddn_supergraph_build.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build
-sidebar_position: 97
+sidebar_position: 99
 description: Perform SupergraphBuild-related operations using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_apply.mdx b/docs/reference/cli/commands/ddn_supergraph_build_apply.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build apply
-sidebar_position: 98
+sidebar_position: 100
 description: Apply a SupergraphBuild to its Project on Hasura DDN using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_apply"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_create.mdx b/docs/reference/cli/commands/ddn_supergraph_build_create.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build create
-sidebar_position: 99
+sidebar_position: 101
 description: Create a SupergraphBuild on Hasura DDN using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_create"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_delete.mdx b/docs/reference/cli/commands/ddn_supergraph_build_delete.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build delete
-sidebar_position: 100
+sidebar_position: 102
 description: Delete SupergraphBuilds from a Project using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_delete"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_diff.mdx b/docs/reference/cli/commands/ddn_supergraph_build_diff.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build diff
-sidebar_position: 101
+sidebar_position: 103
 description: See changes made to the GraphQL schema from one build version to another. using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_diff"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_export-descriptions.mdx b/docs/reference/cli/commands/ddn_supergraph_build_export-descriptions.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build export-descriptions
-sidebar_position: 102
+sidebar_position: 104
 description: Export descriptions for a specific supergraph build using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_export-descriptions"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_get.mdx b/docs/reference/cli/commands/ddn_supergraph_build_get.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build get
-sidebar_position: 103
+sidebar_position: 105
 description: List SupergraphBuilds or get details of a specific one using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_get"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_local.mdx b/docs/reference/cli/commands/ddn_supergraph_build_local.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build local
-sidebar_position: 104
+sidebar_position: 106
 description: Build the Supergraph and generate assets to run the local Engine using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_local"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_build_set-self-hosted-engine-url.mdx b/docs/reference/cli/commands/ddn_supergraph_build_set-self-hosted-engine-url.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph build set-self-hosted-engine-url
-sidebar_position: 105
+sidebar_position: 107
 description: Set the engine's URL for a build for a project in a self hosted data plane. using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_build_set-self-hosted-engine-url"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_init.mdx b/docs/reference/cli/commands/ddn_supergraph_init.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph init
-sidebar_position: 106
+sidebar_position: 108
 description: Initialize a new Supergraph project directory using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_init"
 keywords:

diff --git a/docs/reference/cli/commands/ddn_supergraph_prune.mdx b/docs/reference/cli/commands/ddn_supergraph_prune.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_label: ddn supergraph prune
-sidebar_position: 107
+sidebar_position: 109
 description: Removes unused metadata of the Supergraph using the DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_supergraph_prune"
 keywords: