API: Issue with schema.yaml
### Describe the bug
The schema for publishing episodes is describing a body as JSON:
```
post:
summary: Publish an episode
operationId: publish-episode
parameters:
- name: episodeId
in: path
description: The id of the episode to publish
required: true
schema:
type: integer
format: int64
requestBody:
description: Publish parameters
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/EpisodePublishRequest"
```
While the post for publishing a new episode required multipart/form-data:
```
/episodes/{episodeId}/publish:
post:
summary: Publish an episode
operationId: publish-episode
parameters:
- name: episodeId
in: path
description: The id of the episode to publish
required: true
schema:
type: integer
format: int64
requestBody:
description: Publish parameters
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/EpisodePublishRequest"
```
BUT the publishing new episode only works if I pass the body as form data, not JSON.
### Steps to reproduce
Publishing new episode only works if I pass the body as form data, not JSON.
```
$body = @{
'publication_method' = 'now'
'created_by' = 1
}
$response = Invoke-RestMethod `
-Uri "https://myserver/api/rest/v1/episodes/83/publish" `
-Method Post `
-Headers $headers `
-Form $body
```
### Expected behavior
Expectation is that publishing a the new episode will work as described by the API schema.
### Actual behavior
Publishing new episode does not work if you post application/json.
### Context
- Castopod: lastest production function
- OS: Docker
- Browser: Any
- Web server: Whatever is in the Docker container
### Possible fixes
This schema definition:
```
/episodes/{episodeId}/publish:
post:
summary: Publish an episode
operationId: publish-episode
parameters:
- name: episodeId
in: path
description: The id of the episode to publish
required: true
schema:
type: integer
format: int64
requestBody:
description: Publish parameters
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/EpisodePublishRequest"
```
Should be
```
/episodes/{episodeId}/publish:
post:
summary: Publish an episode
operationId: publish-episode
parameters:
- name: episodeId
in: path
description: The id of the episode to publish
required: true
schema:
type: integer
format: int64
requestBody:
description: Publish parameters
required: true
content:
multipart/form-data:
schema:
$ref: "#/components/schemas/EpisodePublishRequest"
```
The bug is content in the requestBody should be multipeart/form-data.
I will provide a fix if this is an accurate description of the bug and an actual bug.
issue