Can't create schemas in Documentation.
# support
c
@Shubham Bajaj I have been having this problem for a while that i can't create schemas inside of the documentation anymore. Here are some requests that i am doing and getting errors. This is specifically in the "Structured Data", but it is the same anytime you try to create an object. (Tools as an example)
v
You can continue this conversation by mentioning me in the message.
@Chowderr I'm sorry to hear that you're experiencing issues with creating schemas in the documentation. To assist you better, could you please provide me with the specific error messages you're receiving when you attempt to create an object in the "Structured Data" section? Additionally, if you could share the exact steps you're taking or the requests you're making that lead to these errors, that would be very helpful in diagnosing the problem.
s
@Chowderr You're creating the structured plan schema incorrectly. The properties need to follow JSON Schema format because Swagger doesn't allow cyclic dependencies - it shows up as a plain input box instead of a nested schema. Here's the correct version of the structured data schema:
Copy code
json
"schema": {
    "type": "object",
    "properties": {
        "name": { "type": "string" },
        "email": { "type": "string" },
        "phone": { "type": "string" },
        "information": { "type": "string" }
    },
    "description": "Extract the name, phone, email, and booking information from the call.",
    "required": ["name", "email", "phone", "information"]
}
Note: Use Postman API client for handling nested JSON schema properties.
c
I have explained multiple times that we can't do that. If you can show a picture of you inserting these values that would be super. If your answer is " we can't do it from the docs" that makes sense. I have already stated anywhere this works, but not in the docs. If we can't do it in the API/docs why even have it at all. it's literally pointless for all us. I just want to confirm that we can't ever fully create tools in the docs because of Swagger rules correct?
s
> If your answer is " we can't do it from the docs" that makes sense. I have already stated anywhere this works, but not in the docs. Yes cannot be done using API reference docs. > If we can't do it in the API/docs why even have it at all. it's literally pointless for all us. I just want to confirm that we can't ever fully create tools in the docs because of Swagger rules correct? @Chowderr Yes you cannot do this due to Swagger's circular reference rule. Instead, you'll need to use an API client like Postman. Unfortunately, this is a technical limitation we can't work around. However, it's definitely doable using code and other API clients. Give it a try and let me know how it goes! Also I understand your frustation here.