# Postman automatically changed the shape of my API's

**URL:** <https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217>\
**Category:** Help Hub\
**Tags:** collections, api\
**Created:** [March 25, 2024, 2:08pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217 "2024-03-25T14:08:11Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![security-operator-44](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@security-operator-44](https://community.postman.com/u/security-operator-44)\
**Post date:** [March 25, 2024, 2:08pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/1 "2024-03-25T14:08:11Z")

</div>

Hi everyone, i have a problem that is present in many ways. I created my api and some request, but when I close postman, or when I make a “pull request”, postman changes the shape of my Api, adding a “definition”. I did not set a definition in my workspace. I share a screen and I hope someone can hel me.  
 ![screen](https://us1.discourse-cdn.com/getpostman/original/3X/f/6/f64127a974b2d3e20a766f647fe3a474b5953479.png)

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [March 25, 2024, 6:38pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/2 "2024-03-25T18:38:32Z")

</div>

Hey @security-operator-44 👋

Welcome to the Postman Community! :postman:

Would you be able to explain your development workflow a little more, please? I’m not sure I fully understand this issue from your question.

> **[Work with API definitions in Postman | Postman Learning Center](https://learning.postman.com/docs/designing-and-developing-your-api/developing-an-api/defining-an-api/#adding-an-example-api-definition)**
>
> Work with API definitions in Postman: documentation for Postman, the collaboration platform for API development. Create better APIs—faster.

> You create the structure of your API using the _API definition_ . The API definition can consist of one or multiple files. If your API doesn’t have a definition, you can add an example definition, import a definition, or add a definition from a connected repository.

---

<div class="post-metadata">

**Author:** ![security-operator-44](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@security-operator-44](https://community.postman.com/u/security-operator-44)\
**Post date:** [March 26, 2024, 1:17pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/3 "2024-03-26T13:17:32Z")

</div>

Yes sure I wasn’t clear, I know. I have a workspace linked to Azure, I normally create some collections with some requests inside. But, if I close Postman and open it again, I will see my collections in the shape you saw in the screen above. I did not set any Definition, it has been generated automatically. Also, I cannot make a pull on Azure, it block my postman. I just want my collection in the normal shape. I hope I explain the problem clear.

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [March 26, 2024, 1:43pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/4 "2024-03-26T13:43:26Z")

</div>

Where are the requests that you created? Are these in a Collection, in the Collection sidebar?

From the image, I can see a forked API, a Definition, A folder under the Definition and some json spec files.

Apologies, I’m still not really getting what you have done to reach this point and what you create. Can you walk through each step and provide some visual clues to help explain things?

---

<div class="post-metadata">

**Author:** ![security-operator-44](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@security-operator-44](https://community.postman.com/u/security-operator-44)\
**Post date:** [March 26, 2024, 2:00pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/5 "2024-03-26T14:00:59Z")

</div>

Sorry if I’m not clear enough, but I’m pretty new in Postman world. Anyway, as you can see now in the screen, i have created the collection directly from Api’s section, in the sidebar. But i’m sure i did not create any definition. Is it possible this is a problem from Azure?

 ![post](https://us1.discourse-cdn.com/getpostman/original/3X/7/e/7e47801b46a1627eadd166fb1fa285b0d9cab986.png)

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [March 26, 2024, 2:10pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/6 "2024-03-26T14:10:10Z")

</div>

That’s an API in the image and not a Collection, the Collection would be in the section above this.

You can create a Collection based on an API’s Definition though and that would be shown but the Collection would be at the same level as the Definition. You just have a `production` folder and then 4 json spec files and no Collections or Requests.

Here’s an example of one with a Collection:

 ![image](https://us1.discourse-cdn.com/getpostman/original/3X/d/b/db6b272f67ec60d0d72776ffae4fc916dc210f49.png)

The API in the image is connected to a repository but I’m not sure what is held within that to know what’s happening.

---

<div class="post-metadata">

**Author:** ![security-operator-44](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@security-operator-44](https://community.postman.com/u/security-operator-44)\
**Post date:** [March 26, 2024, 2:47pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/7 "2024-03-26T14:47:24Z")

</div>

Ok got it. i saw i can create a collection also from “api” in the sidebar, and that is the way I created my collections. Still I don’t get what is the problem.

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [March 28, 2024, 10:40am UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/8 "2024-03-28T10:40:50Z")

</div>

Hey @security-operator-44 👋

Could you close the same question that you raised here today:

> [@Problem with definition](https://community.postman.com/t/problem-with-definition/59333):
>
> Hi all, I have a problem with my api. I have a workspace linked to a Azure repository. Some days ago I created my api, with some requests inside, but when I push on Azure, or when i close and open again Postman, I see my requests under the “definition”. I did not create definition, and I don’t want it. I see my data like you can see in the first screeshot, but I just want it to be like the second screenshot. I hope i explain my problem well.

And add the details to this open one, which contains more context and an ongoing conversation, please.

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [March 28, 2024, 10:47am UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/9 "2024-03-28T10:47:30Z")

</div>

I still don’t fully understand what your workflow is here.

Do you want to create Collections or an API? Those are 2 different things in the context of Postman.

What is the _Test Statistical API_? How was that created?

 ![hei](https://us1.discourse-cdn.com/getpostman/original/3X/4/e/4ef072178ffc929bba2380d17375b24194f27a59.png)

What Postman files are contained in the Azure repo?

Did you create the link from the API to the repository?

How are you pushing and pulling changes into Postman from the repository?

* * *

What’s the contents of the `.json` files that are in this image?

 ![post](https://us1.discourse-cdn.com/getpostman/original/3X/7/e/7e47801b46a1627eadd166fb1fa285b0d9cab986.png)

Adding relevant link for further context about git linked APIs:

> **[Connect your API to a cloud-hosted Git repository | Postman Learning Center](https://learning.postman.com/docs/designing-and-developing-your-api/versioning-an-api/using-cloud-git-repo/)**
>
> Postman is a collaboration platform for API development. Postman's features simplify each step of building an API and streamline collaboration so you can create better APIs—faster.

> **[Use Postman to push and pull API changes from your Git repository | Postman...](https://learning.postman.com/docs/designing-and-developing-your-api/versioning-an-api/managing-git-changes/)**
>
> Postman is a collaboration platform for API development. Postman's features simplify each step of building an API and streamline collaboration so you can create better APIs—faster.

---

<div class="post-metadata">

**Author:** ![security-operator-44](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@security-operator-44](https://community.postman.com/u/security-operator-44)\
**Post date:** [April 2, 2024, 1:34pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/10 "2024-04-02T13:34:02Z")

</div>

Hi, sorry but its hard to explain without sharing company information, but i’m gonna try to be more clear. My goal is to build an api with some collections inside. Every collection must have some requests inside. I’m gonna answer the question you had above.

- What is the _Test Statistical API_ ? How was that created?  
It is the API that I created, and I wanna put some collections inside.

- How are you pushing and pulling changes into Postman from the repository?  
When i make some changes, I see on the right of the screen, the possibility to commit the changes in Azure.

But, when I make a commit, I see that it fails. Postman stays in loading until I close it. If I close and open again, I see my requests under “definition”, but i did not create any definition. I just want my requests like you can see in the screen, without definition  
 ![image](https://us1.discourse-cdn.com/getpostman/original/3X/e/0/e089db70589d3359c97a555f9c12f8f34788d0e1.png)

---

<div class="post-metadata">

**Author:** ![danny-dainton](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/danny-dainton/32/29401_2.png) [@danny-dainton](https://community.postman.com/u/danny-dainton)\
**Post date:** [April 4, 2024, 3:24pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/11 "2024-04-04T15:24:34Z")

</div>

An API in the context of Postman, isn’t just a container for Collections. It should have a Definition file which would then act as the single source of truth for your API project.

> **[Create an API in Postman | Postman Learning Center](https://learning.postman.com/docs/designing-and-developing-your-api/creating-an-api/)**
>
> Postman is a collaboration platform for API development. Postman's features simplify each step of building an API and streamline collaboration so you can create better APIs—faster.

You can connect various Postman elements of your [API development lifecycle](https://www.postman.com/api-platform/api-lifecycle/) to your API definition, such as collections, documentation, and tests.

Does your API have a schema (_OpenAPI (versions 1.0, 2.0, 3.0, and 3.1), RAML (0.8 and 1.0), protobuf (protocol buffer) (2.0 and 3.0), GraphQL, or WSDL (1.0 and 2.0) definitions_)?

Are you only trying to utilize the git linked part of it? Could you not just create the Collections in the Collection sidebar?

---

<div class="post-metadata">

**Author:** ![system](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/system/32/29796_2.png) [@system](https://community.postman.com/u/system)\
**Post date:** [May 4, 2024, 3:24pm UTC](https://community.postman.com/t/postman-automatically-changed-the-shape-of-my-apis/59217/12 "2024-05-04T15:24:59Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
