Argo · JSON Structure

Argo Workflows Workflow Spec Structure

Specification of a workflow

Type: object Properties: 16
CNCFCI/CDGitOpsKubernetesOpen-SourceProgressive DeliveryWorkflow Engine

WorkflowSpec is a JSON Structure definition published by Argo, describing 16 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

entrypoint arguments templates serviceAccountName volumes activeDeadlineSeconds nodeSelector tolerations parallelism ttlStrategy podGC workflowTemplateRef archiveLogs hooks onExit retryStrategy

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/argo/refs/heads/main/json-structure/argo-workflows-workflow-spec-structure.json",
  "name": "WorkflowSpec",
  "description": "Specification of a workflow",
  "type": "object",
  "properties": {
    "entrypoint": {
      "type": "string",
      "description": "The name of the entrypoint template"
    },
    "arguments": {
      "$ref": "#/components/schemas/Arguments"
    },
    "templates": {
      "type": "array",
      "description": "List of workflow templates",
      "items": {
        "$ref": "#/components/schemas/Template"
      }
    },
    "serviceAccountName": {
      "type": "string",
      "description": "Service account to run workflow pods"
    },
    "volumes": {
      "type": "array",
      "description": "Volumes available to workflow steps",
      "items": {
        "type": "object"
      }
    },
    "activeDeadlineSeconds": {
      "type": "int64",
      "description": "Duration in seconds before workflow times out"
    },
    "nodeSelector": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "tolerations": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "parallelism": {
      "type": "int32",
      "description": "Maximum number of parallel running pods"
    },
    "ttlStrategy": {
      "type": "object",
      "description": "Strategy for cleaning up completed workflows",
      "properties": {
        "secondsAfterCompletion": {
          "type": "int32"
        },
        "secondsAfterSuccess": {
          "type": "int32"
        },
        "secondsAfterFailure": {
          "type": "int32"
        }
      }
    },
    "podGC": {
      "type": "object",
      "description": "Strategy for garbage collecting completed pods",
      "properties": {
        "strategy": {
          "type": "string",
          "enum": [
            "OnPodCompletion",
            "OnPodSuccess",
            "OnWorkflowCompletion",
            "OnWorkflowSuccess"
          ]
        }
      }
    },
    "workflowTemplateRef": {
      "type": "object",
      "description": "Reference to a WorkflowTemplate",
      "properties": {
        "name": {
          "type": "string"
        },
        "clusterScope": {
          "type": "boolean"
        }
      }
    },
    "archiveLogs": {
      "type": "boolean",
      "description": "Whether to archive workflow logs"
    },
    "hooks": {
      "type": "object",
      "description": "Lifecycle hooks for the workflow",
      "additionalProperties": {
        "type": "object"
      }
    },
    "onExit": {
      "type": "string",
      "description": "Template to execute on workflow exit"
    },
    "retryStrategy": {
      "$ref": "#/components/schemas/RetryStrategy"
    }
  }
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • 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 JSON Structure
curl "https://apis.io/api/v1/json-structures/argo-workflows-workflow-spec-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

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