Argo CD SettingsService API

The SettingsService API from Argo CD — 2 operation(s) for settingsservice.

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/settings Get Argo CD settings · Get returns Argo CD settings #
Ask an LLM
“What Argo CD settings are configured?”
“Can I read the global Argo CD settings?”
Tell an agent
Get Argo CD settings.
Show the current Argo CD configuration.
GET /api/v1/settings/plugins List Argo CD plugins · Get returns Argo CD plugins #
Ask an LLM
“Which plugins are installed in Argo CD?”
“Can I list the plugin settings?”
Tell an agent
List Argo CD plugins.
Show the installed plugin settings.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/argocd:argocd-settingsservice-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

argocd-settingsservice-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: Description of all APIs
  title: Consolidate Services Settings Service API
  version: version not set
tags:
- name: SettingsService
paths:
  /api/v1/settings:
    get:
      tags:
      - SettingsService
      summary: Get returns Argo CD settings
      operationId: SettingsService_Get
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clusterSettings'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runtimeError'
  /api/v1/settings/plugins:
    get:
      tags:
      - SettingsService
      summary: Get returns Argo CD plugins
      operationId: SettingsService_GetPlugins
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clusterSettingsPluginsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/runtimeError'
components:
  schemas:
    clusterConnector:
      type: object
      properties:
        name:
          type: string
        type:
          type: string
    v1alpha1ConfigManagementPlugin:
      type: object
      title: ConfigManagementPlugin contains config management plugin configuration
      properties:
        generate:
          $ref: '#/components/schemas/v1alpha1Command'
        init:
          $ref: '#/components/schemas/v1alpha1Command'
        lockRepo:
          type: boolean
        name:
          type: string
    v1alpha1KustomizeVersion:
      type: object
      title: KustomizeVersion holds information about additional Kustomize versions
      properties:
        buildOptions:
          type: string
          title: BuildOptions that are specific to a Kustomize version
        name:
          type: string
          title: Name holds Kustomize version name
        path:
          type: string
          title: Path holds the corresponding binary path
    clusterDexConfig:
      type: object
      properties:
        connectors:
          type: array
          items:
            $ref: '#/components/schemas/clusterConnector'
    clusterOIDCConfig:
      type: object
      properties:
        cliClientID:
          type: string
        clientID:
          type: string
        enablePKCEAuthentication:
          type: boolean
        idTokenClaims:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/oidcClaim'
        issuer:
          type: string
        name:
          type: string
        scopes:
          type: array
          items:
            type: string
    v1alpha1Command:
      type: object
      title: Command holds binary path and arguments list
      properties:
        args:
          type: array
          items:
            type: string
        command:
          type: array
          items:
            type: string
    clusterHelp:
      type: object
      title: Help settings
      properties:
        binaryUrls:
          type: object
          title: the URLs for downloading argocd binaries
          additionalProperties:
            type: string
        chatText:
          type: string
          title: the text for getting chat help, defaults to "Chat now!"
        chatUrl:
          type: string
          title: the URL for getting chat help, this will typically be your Slack channel for support
    v1alpha1OverrideIgnoreDiff:
      type: object
      title: 'OverrideIgnoreDiff contains configurations about how fields should be ignored during diffs between

        the desired state and live state'
      properties:
        jSONPointers:
          type: array
          title: JSONPointers is a JSON path list following the format defined in RFC4627 (https://datatracker.ietf.org/doc/html/rfc6902#section-3)
          items:
            type: string
        jqPathExpressions:
          type: array
          title: JQPathExpressions is a JQ path list that will be evaludated during the diff process
          items:
            type: string
        managedFieldsManagers:
          type: array
          title: 'ManagedFieldsManagers is a list of trusted managers. Fields mutated by those managers will take precedence over the

            desired state defined in the SCM and won''t be displayed in diffs'
          items:
            type: string
    clusterSettingsPluginsResponse:
      type: object
      properties:
        plugins:
          type: array
          items:
            $ref: '#/components/schemas/clusterPlugin'
    clusterPlugin:
      type: object
      title: Plugin settings
      properties:
        name:
          type: string
          title: the name of the plugin, e.g. "kasane"
    runtimeError:
      type: object
      properties:
        code:
          type: integer
          format: int32
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
        error:
          type: string
        message:
          type: string
    v1alpha1KnownTypeField:
      description: 'KnownTypeField contains a mapping between a Custom Resource Definition (CRD) field

        and a well-known Kubernetes type. This mapping is primarily used for unit conversions

        in resources where the type is not explicitly defined (e.g., converting "0.1" to "100m" for CPU requests).'
      type: object
      properties:
        field:
          type: string
          title: 'Field represents the JSON path to the specific field in the CRD that requires type conversion.

            Example: "spec.resources.requests.cpu"'
        type:
          description: 'Type specifies the expected Kubernetes type for the field, such as "cpu" or "memory".

            This helps in converting values between different formats (e.g., "0.1" to "100m" for CPU).'
          type: string
    clusterGoogleAnalyticsConfig:
      type: object
      properties:
        anonymizeUsers:
          type: boolean
        trackingID:
          type: string
    oidcClaim:
      type: object
      properties:
        essential:
          type: boolean
        value:
          type: string
        values:
          type: array
          items:
            type: string
    v1alpha1ResourceOverride:
      type: object
      title: ResourceOverride holds configuration to customize resource diffing and health assessment
      properties:
        actions:
          description: Actions defines the set of actions that can be performed on the resource, as a Lua script.
          type: string
        healthLua:
          description: HealthLua contains a Lua script that defines custom health checks for the resource.
          type: string
        ignoreDifferences:
          $ref: '#/components/schemas/v1alpha1OverrideIgnoreDiff'
        ignoreResourceUpdates:
          $ref: '#/components/schemas/v1alpha1OverrideIgnoreDiff'
        knownTypeFields:
          description: KnownTypeFields lists fields for which unit conversions should be applied.
          type: array
          items:
            $ref: '#/components/schemas/v1alpha1KnownTypeField'
        useOpenLibs:
          description: UseOpenLibs indicates whether to use open-source libraries for the resource.
          type: boolean
    protobufAny:
      type: object
      properties:
        type_url:
          type: string
        value:
          type: string
          format: byte
    v1alpha1KustomizeOptions:
      type: object
      title: KustomizeOptions are options for kustomize to use when building manifests
      properties:
        binaryPath:
          description: 'Deprecated: Use settings.Settings instead. See: settings.Settings.KustomizeVersions.

            If this field is set, it will be used as the Kustomize binary path.

            Otherwise, Versions is used.'
          type: string
          title: BinaryPath holds optional path to kustomize binary
        buildOptions:
          type: string
          title: BuildOptions is a string of build parameters to use when calling `kustomize build`
        versions:
          description: Versions is a list of Kustomize versions and their corresponding binary paths and build options.
          type: array
          items:
            $ref: '#/components/schemas/v1alpha1KustomizeVersion'
    clusterSettings:
      type: object
      properties:
        additionalUrls:
          type: array
          items:
            type: string
        appLabelKey:
          type: string
        appsInAnyNamespaceEnabled:
          type: boolean
        configManagementPlugins:
          description: 'Deprecated: use sidecar plugins instead.'
          type: array
          items:
            $ref: '#/components/schemas/v1alpha1ConfigManagementPlugin'
        controllerNamespace:
          type: string
        dexConfig:
          $ref: '#/components/schemas/clusterDexConfig'
        execEnabled:
          type: boolean
        googleAnalytics:
          $ref: '#/components/schemas/clusterGoogleAnalyticsConfig'
        help:
          $ref: '#/components/schemas/clusterHelp'
        hydratorEnabled:
          type: boolean
        impersonationEnabled:
          type: boolean
        installationID:
          type: string
        kustomizeOptions:
          $ref: '#/components/schemas/v1alpha1KustomizeOptions'
        kustomizeVersions:
          type: array
          items:
            type: string
        oidcConfig:
          $ref: '#/components/schemas/clusterOIDCConfig'
        passwordPattern:
          type: string
        plugins:
          type: array
          items:
            $ref: '#/components/schemas/clusterPlugin'
        resourceOverrides:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/v1alpha1ResourceOverride'
        statusBadgeEnabled:
          type: boolean
        statusBadgeRootUrl:
          type: string
        syncWithReplaceAllowed:
          type: boolean
        trackingMethod:
          type: string
        uiBannerContent:
          type: string
        uiBannerPermanent:
          type: boolean
        uiBannerPosition:
          type: string
        uiBannerURL:
          type: string
        uiCssURL:
          type: string
        url:
          type: string
        userLoginsDisabled:
          type: boolean