OpenAPI spec schemas with default value not in enums

[jlumpe]

The following schemas in the OpenAPI spec have default value "DEFAULT", which is not one of their defined enum values:

• v2AnnotationForAssemblyType
• v2AnnotationForOrganelleType
• v2AssemblyLinksReplyAssemblyLinkType
• v2GeneLinksReplyGeneLinkType
• v2GenomeAnnotationRequestAnnotationType

This is causing me errors when trying to generate a Python API client with OpenAPI Generator.

I'm not too familiar with the OpenAPI specification, but from what I was able to gather the value of the default property must validate against the schema (swagger.io docs, this is different than Json Schema where is is merely suggested).

Based on my understanding, the value "DEFAULT" should be added to the enum property of these schemas.

[syntheticgio]

Hi @jlumpe. Thanks for pointing this out. Looks like it is an internal edge case for how we generate those schemas. They actually do have DEFAULT as a value but apparently there is a conflict (I believe because 'DEFAULT' is clashing since they are all put in the same namespace - but that is just a guess at the moment).

We're working on getting that fixed (it should be fairly quick but needs to go through our internal processes and won't be done as an 'emergency' type fix). If you would like to manually patch these for the time being (to unblock yourself), here are the values:

v2AnnotationForAssemblyType

GENOME_GFF
GENOME_GBFF
RNA_FASTA
PROT_FASTA
GENOME_GTF
CDS_FASTA
ASM_STRUCT
GENOME_FASTA
SEQUENCE_REPORT

v2AnnotationForOrganelleType

GENOME_FASTA
CDS_FASTA
PROTEIN_FASTA

v2AssemblyLinksReplyAssemblyLinkType

GDV_LINK
FTP_LINK
ASSEMBLY_PUBMED
BLAST_LINK
ASSEMBLY_NUCCORE_REFSEQ
ASSEMBLY_NUCCORE_GENBANK

v2GeneLinksReplyGeneLinkType

GENE_LINK
GDV_LINK
ORTHOLOG_LINK
MCGV_LINK

v2GenomeAnnotationRequestAnnotationType

GENOME_FASTA
RNA_FASTA
PROT_FASTA

Hopefully that helps! I'll leave this ticket open until the fix is added to the code.