Argo Workflows API — Workflow Archives

naftiko: 1.0.0-alpha2
info:
  label: Argo Workflows API — Workflow Archives
  description: 'Argo Workflows API — Workflow Archives. 3 operations. Lead operation: Argo Workflows Argo List Archived Workflows.
    Self-contained Naftiko capability covering one Argo business surface.'
  tags:
  - Argo
  - Workflow Archives
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ARGO_API_KEY: ARGO_API_KEY
capability:
  consumes:
  - type: http
    namespace: workflows-workflow-archives
    baseUri: https://{host}:{port}/api/v1
    description: Argo Workflows API — Workflow Archives business capability. Self-contained, no shared references.
    resources:
    - name: archived-workflows
      path: /archived-workflows
      operations:
      - name: listarchivedworkflows
        method: GET
        description: Argo Workflows Argo List Archived Workflows
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: listOptions.labelSelector
          in: query
          type: string
          description: Label selector to filter archived workflows
        - name: listOptions.limit
          in: query
          type: integer
          description: Maximum number of results to return
        - name: listOptions.continue
          in: query
          type: string
          description: Continue token for pagination
        - name: namespace
          in: query
          type: string
          description: Namespace to filter archived workflows
    - name: archived-workflows-uid
      path: /archived-workflows/{uid}
      operations:
      - name: getarchivedworkflow
        method: GET
        description: Argo Workflows Argo Get an Archived Workflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: uid
          in: path
          type: string
          description: UID of the archived workflow
          required: true
      - name: deletearchivedworkflow
        method: DELETE
        description: Argo Workflows Argo Delete an Archived Workflow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: uid
          in: path
          type: string
          description: UID of the archived workflow
          required: true
    authentication:
      type: bearer
      token: '{{env.ARGO_API_KEY}}'
  exposes:
  - type: rest
    namespace: workflows-workflow-archives-rest
    port: 8080
    description: REST adapter for Argo Workflows API — Workflow Archives. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/archived-workflows
      name: archived-workflows
      description: REST surface for archived-workflows.
      operations:
      - method: GET
        name: listarchivedworkflows
        description: Argo Workflows Argo List Archived Workflows
        call: workflows-workflow-archives.listarchivedworkflows
        with:
          listOptions.labelSelector: rest.listOptions.labelSelector
          listOptions.limit: rest.listOptions.limit
          listOptions.continue: rest.listOptions.continue
          namespace: rest.namespace
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/archived-workflows/{uid}
      name: archived-workflows-uid
      description: REST surface for archived-workflows-uid.
      operations:
      - method: GET
        name: getarchivedworkflow
        description: Argo Workflows Argo Get an Archived Workflow
        call: workflows-workflow-archives.getarchivedworkflow
        with:
          uid: rest.uid
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletearchivedworkflow
        description: Argo Workflows Argo Delete an Archived Workflow
        call: workflows-workflow-archives.deletearchivedworkflow
        with:
          uid: rest.uid
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: workflows-workflow-archives-mcp
    port: 9090
    transport: http
    description: MCP adapter for Argo Workflows API — Workflow Archives. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: argo-workflows-argo-list-archived
      description: Argo Workflows Argo List Archived Workflows
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: workflows-workflow-archives.listarchivedworkflows
      with:
        listOptions.labelSelector: tools.listOptions.labelSelector
        listOptions.limit: tools.listOptions.limit
        listOptions.continue: tools.listOptions.continue
        namespace: tools.namespace
      outputParameters:
      - type: object
        mapping: $.
    - name: argo-workflows-argo-get-archived
      description: Argo Workflows Argo Get an Archived Workflow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: workflows-workflow-archives.getarchivedworkflow
      with:
        uid: tools.uid
      outputParameters:
      - type: object
        mapping: $.
    - name: argo-workflows-argo-delete-archived
      description: Argo Workflows Argo Delete an Archived Workflow
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: workflows-workflow-archives.deletearchivedworkflow
      with:
        uid: tools.uid
      outputParameters:
      - type: object
        mapping: $.