Skip to content

OpenAPI schema: execution.workflowId incorrectly typed as number instead of string #24123

@poodle64

Description

@poodle64

Summary

The OpenAPI schema at /api/v1/openapi.yml defines execution.workflowId as type: number, but n8n returns alphanumeric string workflow IDs.

Schema Location

components/schemas/execution/properties/workflowId

Current (incorrect)

workflowId:
  type: number
  example: '1000'

Expected (correct)

workflowId:
  type: string
  example: '2tUt1wbLX592XDdX'

Evidence

The same schema correctly types workflowId as string in other locations:

  • sharedWorkflow.workflowId: type: string, example: 2tUt1wbLX592XDdX
  • workflowVersion.workflowId: type: string
  • importResult.tags.mappings[].workflowId: type: string
  • Path parameter workflowId: type: string

Only execution.workflowId is incorrectly typed as number.

Impact

API clients generated from this schema fail to deserialize execution responses because workflow IDs like hykP7o8yHNvRiyOP cannot be parsed as numbers.

n8n Version

Observed in n8n v1.1.1 OpenAPI schema (current public API)

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions