For the complete documentation index, see llms.txt. This page is also available as Markdown.

Argo CD

Argo CD is a GitOps continuous-delivery tool for Kubernetes. Read applications and projects, create applications, and request syncs or rollbacks from your workflows.

Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

Connector
Authentication

Argo CD (API Token)

API token

Argo CD (API Token)

Connect to your Argo CD server to read applications and projects and create, sync, or roll back applications.

Set up in Argo CD

  1. Ask your Argo CD administrator for a publicly reachable HTTPS API server and an expiring local-account or project-role API token. Argo CD Core does not include the required API server.

  2. Grant application read access, application create and sync permissions for the intended project, and project read access. Confirm rollback permissions against your installed Argo CD version.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Argo CD (API Token).

  2. Enter the credentials and connection details in the fields below.

  3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connection fields

StackAI field
Required
What to enter

Server URL

Yes

Your public HTTPS Argo CD server address, without /api.

API token

Yes

An unexpired project-role or local-account token. Grant applications get, create, and sync as needed, plus projects get for project lists. The connection check verifies sign-in; action permissions are checked when each action runs. Provider instructions.

Provider documentation: Setup reference.

Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

Use an action

  1. Add the required Argo CD action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

Actions

Create Application

Create an Argo CD application without deploying it.

Inputs

Field
Type
Required
Description

Application name

string

Yes

A unique name for the new application.

Project

select (string)

Yes

The project that allows this repository and destination. Options load from the selected connection.

Repository URL

string

Yes

The Git repository containing the application.

Repository path

string

Yes

Folder containing the manifests, relative to the repository root.

Target revision

string

Yes

The Git branch, tag, or commit SHA to deploy when synced.

Destination server URL

string

Yes

The registered Kubernetes cluster server URL.

Destination namespace

string

Yes

An existing namespace for the application workloads.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Outputs

Field
Type
Description

Name

string

The application name.

Project

string

The application project.

Application namespace

string

The namespace containing the Application.

Request status

string

Application registration was accepted; no deployment was requested.

Roll Back Application

Restore a previous application deployment, with a dry run by default.

Inputs

Field
Type
Required
Description

Project

select (string)

No

Limit the application lookup to this project.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Application name

select (string)

Yes

Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.

History ID

select (string)

Yes

Choose a previous deployment or enter its numeric history ID. Options load from the selected connection.

Dry run

boolean

No

Preview the rollback without changing workloads. Turn off to apply changes. Default: true.

Outputs

Field
Type
Description

Name

string

The application name.

Sync status

string

The sync status returned when Argo CD accepted the request. Check again to confirm completion.

Health status

string

The health status returned when Argo CD accepted the request. Check again after the operation finishes.

Operation phase

string

Left empty because the operation may still be running. Use Get Application Status to check progress.

Request status

string

Whether Argo CD accepted a preview or a deployment request. This does not confirm completion.

History ID

integer

The requested deployment history ID.

List Applications

List the Argo CD applications visible to the connected token.

Inputs

Field
Type
Required
Description

Project

select (string)

No

Optional Argo CD project name to filter applications by.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Max results

integer

No

Max applications to return (1-5000). Minimum: 1. Maximum: 5000.

Outputs

Field
Type
Description

Applications

dict_array

Applications visible to the connected token.

Count

integer

Number of applications returned.

Truncated

boolean

Whether more results exist than the selected limit.

Get Application

Get details for a single Argo CD application.

Inputs

Field
Type
Required
Description

Project

select (string)

No

Limit the application lookup to this project.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Application name

select (string)

Yes

Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.

Outputs

Field
Type
Description

Name

string

The application name.

Project

string

The Argo CD project the application belongs to.

Sync status

string

Whether live resources match the desired state (Synced, OutOfSync, Unknown).

Health status

string

The application's health (Healthy, Progressing, Degraded, etc.).

Repository URL

string

The Git or Helm repository URL of the application's primary source.

Target revision

string

The primary source's target revision (branch, tag, commit SHA, or chart version).

Destination namespace

string

The Kubernetes namespace the application deploys into.

Resource tree

object

Up to 200 resources with their health and parent relationships.

Deployment history

dict_array

Recent deployments available for rollback.

History truncated

boolean

Whether older deployment records were omitted.

Get Application Status

Get the sync and health status summary for an Argo CD application.

Inputs

Field
Type
Required
Description

Project

select (string)

No

Limit the application lookup to this project.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Application name

select (string)

Yes

Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.

Outputs

Field
Type
Description

Name

string

The application name.

Sync status

string

Whether live resources match the desired state (Synced, OutOfSync, Unknown).

Health status

string

The application's health (Healthy, Progressing, Degraded, etc.).

Health message

string

A human-readable detail about the current health, if any.

Operation phase

string

Phase of the latest sync or rollback operation, or empty if none has run.

List Projects

List the Argo CD projects visible to the connected token.

Inputs

Field
Type
Required
Description

Max results

integer

No

Max projects to return (1-5000). Minimum: 1. Maximum: 5000.

Outputs

Field
Type
Description

Projects

dict_array

Projects visible to the connected token.

Count

integer

Number of projects returned.

Truncated

boolean

Whether more results exist than the selected limit.

Sync Application

Preview or request a sync for an Argo CD application.

Inputs

Field
Type
Required
Description

Project

select (string)

No

Limit the application lookup to this project.

Application namespace

string

No

The namespace where Argo CD stores the application, which may differ from its workload namespace.

Application name

select (string)

Yes

Choose an application or enter its name, optionally as namespace/name. Options load from the selected connection.

Revision

string

No

Optional revision (branch, tag, commit SHA, or chart version) to sync to.

Dry run

boolean

No

Preview the sync without changing workloads. Turn off to apply changes. Default: true.

Outputs

Field
Type
Description

Name

string

The application name.

Sync status

string

The sync status returned when Argo CD accepted the request. Check again to confirm completion.

Health status

string

The health status returned when Argo CD accepted the request. Check again after the operation finishes.

Operation phase

string

Left empty because the operation may still be running. Use Get Application Status to check progress.

Request status

string

Whether Argo CD accepted a preview or a deployment request. This does not confirm completion.

Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.

Last updated

Was this helpful?