Kong / Kong/docs.konghq.com

Add developer portal /files POST example

Open
#4,413 7 comments 1 reaction 0 assignees View on GitHub
Dominant language
Ruby
Stars
212
Forks
587
PR merge metrics
No merged PRs in 30d

Description

### Where is the problem?

https://docs.konghq.com/gateway/latest/developer-portal/portal-api/#/

### What happened?

Hi,

Noticed there isn't currently a POST example for the /files endpoint for the scenario of adding an OpenAPI specification to the portal.

I have been able to do this with the following cul command -

curl -X POST localhost:8001/files -F "path=specs/tfl_openapi.yaml" -F "contents=@tfl_openapi.yaml"

Thanks

Mark

### What did you expect to happen?

A POST example next to https://docs.konghq.com/gateway/latest/developer-portal/portal-api/#/operations/list-files

### Code of Conduct and Community Expectations

- [X] I agree to follow this project's Code of Conduct
- [X] I agree to abide by the Community Expectations

Contributor guide

No contributing guide indexed for this repository

Research direction

Start at the developer portal Portal API documentation linked in the issue and locate the list-files operation. Add a POST example for uploading an OpenAPI specification using the supplied curl command; done means the example appears next to that operation in the published documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.