Using application/json and multipart/form-data on a single endpoint conditionally

[Crian69]

I have a endpoint that accepts application/json and multipart/form-data based on the type of data i am sending, but it seems that generated client is missing few parameters.

Swagger Json

            "post": {
                "security": [
                    {
                        "BearerAuth": []
                    }
                ],
                "description": "Send a message to a chat room. Use `application/json` for text-only messages or `multipart/form-data` for messages with attachments.",
                "consumes": [
                    "application/json",
                    "multipart/form-data"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Messages"
                ],
                "summary": "Send a message in a specific room",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "ID of the room where the message is being sent",
                        "name": "roomID",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "Message payload for application/json",
                        "name": "jsonPayload",
                        "in": "body",
                        "schema": {
                            "$ref": "#/definitions/models.MessageCreatePayload"
                        }
                    },
                    {
                        "type": "string",
                        "description": "JSON string of the message payload (for multipart/form-data)",
                        "name": "payload_json",
                        "in": "formData"
                    },
                    {
                        "type": "file",
                        "description": "Attachment files (for multipart/form-data)",
                        "name": "files",
                        "in": "formData"
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Message sent successfully",
                        "schema": {
                            "$ref": "#/definitions/models.MessageResponse"
                        }
                    },
                    "400": {
                        "description": "Invalid input or bad request",
                        "schema": {
                            "$ref": "#/definitions/models.ErrorResponse"
                        }
                    },
                    "401": {
                        "description": "Unauthorized access, user needs to be authenticated",
                        "schema": {
                            "$ref": "#/definitions/models.ErrorResponse"
                        }
                    },
                    "415": {
                        "description": "Unsupported content type, use application/json or multipart/form-data",
                        "schema": {
                            "$ref": "#/definitions/models.ErrorResponse"
                        }
                    },
                    "500": {
                        "description": "Internal server error, failed to send the message",
                        "schema": {
                            "$ref": "#/definitions/models.ErrorResponse"
                        }
                    }
                }
            }

Swagger UI

Generated Function For Endpoin

export const postRoomsByRoomIdMessages = <ThrowOnError extends boolean = false>(
  options: Options<PostRoomsByRoomIdMessagesData, ThrowOnError>
) => {
  return (options?.client ?? client).post<
    PostRoomsByRoomIdMessagesResponse,
    PostRoomsByRoomIdMessagesError,
    ThrowOnError
  >({
    ...options,
    ...formDataBodySerializer,
    headers: {
      "Content-Type": null,
      ...options?.headers,
    },
    url: "/rooms/{roomID}/messages",
  });
};

PostRoomsByRoomIdMessagesData Type

export type PostRoomsByRoomIdMessagesData = {
  /**
   * Message payload for application/json
   */
  body?: models_MessageCreatePayload;
  path: {
    /**
     * ID of the room where the message is being sent
     */
    roomID: number;
  };
};

Type models_MessageCreatePayload

export type models_MessageCreatePayload = {
  /**
   * Content is required if no files are provided
   */
  content?: string;
  /**
   * Optional: ID of the message being replied to
   */
  reply_to?: number;
};

[mrlubos]

You're right @Crian69, this is one of the current limitations. How would you write the type and service function manually if you wanted to handle this?