# Swagger

**URL:** https://community.smartbear.com/c/api/swagger/19.md

[Latest](https://community.smartbear.com/latest.md) · [Categories](https://community.smartbear.com/categories.md) · [Tags](https://community.smartbear.com/tags.md)

---

## [How long does the free plan keep data?](https://community.smartbear.com/t/how-long-does-the-free-plan-keep-data/809)

<div class="topic-metadata">

**Author:** [@Sofia\_KILANI](https://community.smartbear.com/u/Sofia_KILANI)\
**Replies:** 1\
**Last updated:** [October 29, 2026, 11:09am UTC](https://community.smartbear.com/t/how-long-does-the-free-plan-keep-data/809 "2026-10-29T11:09:12Z")

</div>

I’m looking to use PactFlow’s free plan. Does anyone know how long data is kept? Cheers

---

## [About the Swagger category](https://community.smartbear.com/t/about-the-swagger-category/34)

<div class="topic-metadata">

**Author:** [@tanzeem](https://community.smartbear.com/u/tanzeem)\
**Replies:** 1\
**Last updated:** [October 26, 2026, 8:17am UTC](https://community.smartbear.com/t/about-the-swagger-category/34 "2026-10-26T08:17:49Z")

</div>

Discuss Swagger Studio, Portal, and Contract Testing for API design, governance, and documentation.

---

## [Error. 412: We only support one authentication type at this time.](https://community.smartbear.com/t/error-412-we-only-support-one-authentication-type-at-this-time/441)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 1\
**Last updated:** [July 7, 2026, 1:24pm UTC](https://community.smartbear.com/t/error-412-we-only-support-one-authentication-type-at-this-time/441 "2026-07-07T13:24:23Z")

</div>

Originally posted by zeballosyovanny on April 15, 2026 Hello everyone, I’m having trouble logging into my Gmail account. I’m getting the following message: “Error 412: We only support one authentication type at this t…

---

## [Retrieve documentId for Portal documents](https://community.smartbear.com/t/retrieve-documentid-for-portal-documents/525)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 0\
**Last updated:** [June 29, 2026, 10:13pm UTC](https://community.smartbear.com/t/retrieve-documentid-for-portal-documents/525 "2026-06-29T22:13:40Z")

</div>

Originally posted by psorenson on June 29, 2026 Would like to test ability using GET and PATCH to review and modify markdown pages (documents) in the Swagger Hub Portal product. I am not seeing an easy way to recover …

---

## [How to get real-person support?](https://community.smartbear.com/t/how-to-get-real-person-support/430)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 1\
**Last updated:** [April 10, 2026, 9:45am UTC](https://community.smartbear.com/t/how-to-get-real-person-support/430 "2026-04-10T09:45:27Z")

</div>

Originally posted by toddrimes on April 09, 2026 How do I actually file a support ticket? I followed a link that said ‘file a support ticket’, but the page was just links to FAQs and self-support discussion threads.

---

## [Why should I use SmartBear AI to create APIs using prompts versus ChatGPT or Claude?](https://community.smartbear.com/t/why-should-i-use-smartbear-ai-to-create-apis-using-prompts-versus-chatgpt-or-claude/424)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 0\
**Last updated:** [April 7, 2026, 9:08am UTC](https://community.smartbear.com/t/why-should-i-use-smartbear-ai-to-create-apis-using-prompts-versus-chatgpt-or-claude/424 "2026-04-07T09:08:29Z")

</div>

Originally posted by yousaf on April 07, 2026 An often asked question to our SmartBear solution engineers, is why should I use Swagger Studio to create my API’s with SmartBear AI, versus using my favourite LLM. Liste…

---

## [It does not seem like setting a header in a response as required makes any difference](https://community.smartbear.com/t/it-does-not-seem-like-setting-a-header-in-a-response-as-required-makes-any-difference/273)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 6\
**Last updated:** [April 3, 2025, 9:49am UTC](https://community.smartbear.com/t/it-does-not-seem-like-setting-a-header-in-a-response-as-required-makes-any-difference/273 "2025-04-03T09:49:23Z")

</div>

Originally posted by HenrikHL on March 05, 2025 I would expect a little red \\\* to appear next to the header-name when I specify the header as a required-header. Here is an example As can be seen - no required “re…

---

## [issues with nestJS/swagger](https://community.smartbear.com/t/issues-with-nestjs-swagger/269)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 3\
**Last updated:** [May 28, 2024, 5:50pm UTC](https://community.smartbear.com/t/issues-with-nestjs-swagger/269 "2024-05-28T17:50:44Z")

</div>

Originally posted by topachi on May 24, 2024 Hello, i have a few issues regarding NESTJS/SWAGGER missing namespace in swagger UI when it should be if there are different classes/namespaces with the same cla…

---

## [enum query parameter with "explode: false" not working](https://community.smartbear.com/t/enum-query-parameter-with-explode-false-not-working/150)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 6\
**Last updated:** [March 25, 2024, 5:26am UTC](https://community.smartbear.com/t/enum-query-parameter-with-explode-false-not-working/150 "2024-03-25T05:26:43Z")

</div>

Originally posted by ravik51378 on March 14, 2024 I have a query parameter whose data type is enum as below. When I send the parameter with one value as “?status=ACTIVE” it is working fine. But when I send with two va…

---

## [The use of oneOf or anyOf in arrays](https://community.smartbear.com/t/the-use-of-oneof-or-anyof-in-arrays/265)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 6\
**Last updated:** [September 19, 2023, 10:38am UTC](https://community.smartbear.com/t/the-use-of-oneof-or-anyof-in-arrays/265 "2023-09-19T10:38:44Z")

</div>

Originally posted by HenrikHL on September 12, 2023 Hi all, We have been discussing internally of how to use the oneOf and anyOf keywords in arrays. Suppose we have the following 2 items (Dog and Cat) Dog: type: …

---

## [Swagger UI is showing "null" for "Example Value" for every API endpoint of our application](https://community.smartbear.com/t/swagger-ui-is-showing-null-for-example-value-for-every-api-endpoint-of-our-application/263)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 2\
**Last updated:** [August 15, 2023, 9:28pm UTC](https://community.smartbear.com/t/swagger-ui-is-showing-null-for-example-value-for-every-api-endpoint-of-our-application/263 "2023-08-15T21:28:21Z")

</div>

Originally posted by nbrooks3 on August 14, 2023 I’m not very familiar with the backend of our application, but am trying to investigate why our all of our endpoints are missing “example values” on our app’s Swagger p…

---

## [Delete with Request Body / Payload](https://community.smartbear.com/t/delete-with-request-body-payload/262)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 1\
**Last updated:** [August 10, 2023, 9:51am UTC](https://community.smartbear.com/t/delete-with-request-body-payload/262 "2023-08-10T09:51:27Z")

</div>

Originally posted by swagcoder on August 09, 2023 How to design for a DELETE request having a Request Body or Payload in version 3.0.0 in:“body” or requestBody: is supported for DELETE it seems. What is the work arou…

---

## ['😱 Could not render this component, see the console' Issue on SwaggerHub UI](https://community.smartbear.com/t/could-not-render-this-component-see-the-console-issue-on-swaggerhub-ui/261)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 2\
**Last updated:** [May 30, 2023, 7:14pm UTC](https://community.smartbear.com/t/could-not-render-this-component-see-the-console-issue-on-swaggerhub-ui/261 "2023-05-30T19:14:18Z")

</div>

Originally posted by Soumik on May 30, 2023 Hello, I used the Inspector tool to autogenerate our swagger by manually running the APIs from the tool. This auto-generates the .yaml file for the documentation. However …

---

## [Pagination with swagger 3 and open api 3](https://community.smartbear.com/t/pagination-with-swagger-3-and-open-api-3/255)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 1\
**Last updated:** [December 16, 2022, 8:26pm UTC](https://community.smartbear.com/t/pagination-with-swagger-3-and-open-api-3/255 "2022-12-16T20:26:32Z")

</div>

Originally posted by AleMors85 on December 14, 2022 Hello!! A pleasure to be here i nthis community!! A question, hwo can I implement a pagination in swagger with open api 3 code generation? I am using a gradle task…

---

## [Unable to render this definition The provided definition does not specify a valid version field.](https://community.smartbear.com/t/unable-to-render-this-definition-the-provided-definition-does-not-specify-a-valid-version-field/243)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 0\
**Last updated:** [April 20, 2021, 7:12pm UTC](https://community.smartbear.com/t/unable-to-render-this-definition-the-provided-definition-does-not-specify-a-valid-version-field/243 "2021-04-20T19:12:45Z")

</div>

Originally posted by zealoustechie on April 20, 2021 Hello: I generated the python-flask server stubs from the swagger hub, plugged in all the code and when I run the code locally, the swagger-ui works fine with /api…

---

## [OpenAPi 3.0.3 - can I use two POST methods for the same path  - each with its own request body?](https://community.smartbear.com/t/openapi-3-0-3-can-i-use-two-post-methods-for-the-same-path-each-with-its-own-request-body/238)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 5\
**Last updated:** [February 15, 2021, 7:39am UTC](https://community.smartbear.com/t/openapi-3-0-3-can-i-use-two-post-methods-for-the-same-path-each-with-its-own-request-body/238 "2021-02-15T07:39:18Z")

</div>

Originally posted by Nixol on November 15, 2020 can I use two POST methods for the same path with each operation having its own request body? If it is not possible, how cab I achieve this? I use OpenApi 3.0.3

---

## [OAS3 Reference to external document schemas](https://community.smartbear.com/t/oas3-reference-to-external-document-schemas/185)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 1\
**Last updated:** [February 12, 2021, 12:17am UTC](https://community.smartbear.com/t/oas3-reference-to-external-document-schemas/185 "2021-02-12T00:17:39Z")

</div>

Originally posted by Bains on February 11, 2021 Hi, In my root api document (openapi.yaml) file, I am trying to make a reference ($ref) to a schema in an external document that is located in a directory under the roo…

---

## [Host swagger API documentation on my own server](https://community.smartbear.com/t/host-swagger-api-documentation-on-my-own-server/217)

<div class="topic-metadata">

**Author:** [@system](https://community.smartbear.com/u/system)\
**Replies:** 8\
**Last updated:** [August 29, 2017, 11:27am UTC](https://community.smartbear.com/t/host-swagger-api-documentation-on-my-own-server/217 "2017-08-29T11:27:53Z")

</div>

Originally posted by parminder on May 10, 2017 Hello, I have created two pages which is available publicly. I want to host those pages on my own server. I saw the documentation and github for swagger-ui and swagger-…
