> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/data-sources/argocd.md).

# ArgoCD

## What the Agent Can Do

* List all ArgoCD applications and their sync status
* Get detailed app health — sync state, conditions, resource tree
* View sync history — who deployed what, when, and from which commit
* Check Kubernetes events for a specific application

## Setup Instructions

1. Log into your **ArgoCD instance**
2. Go to **Settings** > **Accounts** > select your account
3. Click **Generate New** under Tokens
4. Give it a name (e.g., `Pagerly`) and click **Generate**
5. Copy the token and your ArgoCD URL

## Required Credentials

| Field          | Description            | Example                      |
| -------------- | ---------------------- | ---------------------------- |
| **API Token**  | ArgoCD API token       | `eyJhbGciOiJIUzI1NiIs...`    |
| **ArgoCD URL** | Your ArgoCD server URL | `https://argocd.company.com` |

{% hint style="info" %}
**Read-only access is sufficient.** The agent only queries app status and history — it does not trigger syncs or modify applications.
{% endhint %}

## Context Prompt Tips

> *"Our apps are in the production project. Main apps: api-gateway, payment-service. We use auto-sync for staging."*

## Docs

* [ArgoCD API Docs](https://argo-cd.readthedocs.io/en/stable/developer-guide/api-docs/)