Workflows

List workflows (Beta)

Beta. List workflows visible to your organization. Includes both your org's private workflows and curated Valyu workflows. Run a workflow by passing its slug as workflow_id to POST /v1/deepresearch/tasks.

get/v1/workflows

Request

  • Base URL: https://api.valyu.ai
  • URL: https://api.valyu.ai/v1/workflows
  • Auth: API key in header X-API-Key

Query parameters

verticalstring

Filter by vertical (e.g. finance, life-sciences).

scope'valyu' | 'org' | 'all'

Which workflows to return: valyu (curated only), org (your org only), or all (both, default).

qstring

Free-text search across title, subtitle, and description.

tagsstring

Comma-separated tags to filter by.

limitinteger

Maximum number of workflows to return (max 100).

expandstring

Comma-separated list of fields to expand. Pass version to include the full current version row for each workflow.

Response

List of workflows.

totalinteger required

Total number of workflows matching the filter.

next_cursorstring nullable

Pagination cursor for the next page, or null when there are no more results.

verticalsstring[]

Distinct verticals present across the curated catalog.

Example response

{
  "workflows": [
    {
      "slug": "ib-company-profile",
      "version": 1,
      "vertical": "investment-banking",
      "tags": [
        "company-profile",
        "equities"
      ],
      "title": "Company Profile",
      "subtitle": "One-page profile of a public company.",
      "description": "Builds a company profile covering business, financials, and recent developments.",
      "popular": true,
      "recommended_mode": "heavy",
      "estimated_time": "10-20 min",
      "is_valyu": true,
      "variables": [
        {
          "key": "company",
          "label": "Company name",
          "type": "text",
          "placeholder": "NVIDIA (NVDA)",
          "help": "The company you want to profile.",
          "examples": [
            "NVIDIA (NVDA)",
            "Microsoft (MSFT)"
          ]
        }
      ],
      "deliverables": [
        {
          "type": "xlsx",
          "description": "A model summary tab with revenue, margins, and key ratios."
        }
      ],
      "created_at": "2026-01-10T12:00:00Z",
      "updated_at": "2026-01-15T09:30:00Z",
      "prompt": "Build a company profile for {company} covering its business, financials, and recent developments.",
      "output_formats": [
        {
          "type": "object",
          "properties": {
            "base_case": {
              "type": "string"
            },
            "bull_case": {
              "type": "string"
            },
            "bear_case": {
              "type": "string"
            },
            "confidence": {
              "type": "number"
            }
          }
        },
        "toon"
      ]
    }
  ],
  "total": 44,
  "verticals": [
    "consulting",
    "private-equity",
    "life-sciences",
    "investment-banking",
    "hedge-funds",
    "legal-regulatory",
    "sales-intelligence",
    "supply-chain"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.