If the API docs for models/schema are not available look at the web UI for agents. The required fields will in the form will be the ones we want to handle. Sometimes you may have to experiment and guess.
The API validates the requests. The response case from the API will often hint at what we’re missing. curl can be a real help here as the error response in JSON wil give us clues to what is missing. Sometimes that is not as visible from the Python shell.
Relying on the API validation does allow us to simplify our client code but we need to do more in our tests sorting out the right structure to send.