Home
Argo
Argo Workflows Workflow Spec Structure
Argo Workflows Workflow Spec Structure
Specification of a workflow
Type: object
Properties: 16
CNCF CI/CD GitOps Kubernetes Open-Source Progressive Delivery Workflow 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
{
"$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"
}
}
}
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.