Post organisations schemas
Create a new schema, which can be used to create an App and in the future be used to reconfigure an existing App.
Authorizations
Path Parameters
Body
URL is the address where the schema file is hosted. This may be an externally accessible http(s):// URL, or a gs:// URL which Switchboard is granted access to.
Type is the schema type being created. The only type currently supported is "openapi".
Async is a flag to indicate whether the schema should be created asynchronously. This will result in a 201 Accepted response for which the response body will be different to the regular synchronous response.
Response
Type denotes the type of schema the corresponding App is backed by. Currently the only supported value is "openapi", but other types such as "soap", "graphql" and "grpc" are on the roadmap.
Version denotes the version of the schema specification. This property is contextual based on the schema
type, for example openapi schemas will contain the OpenAPI specification version (currently only 3.0.x is
supported), but grpc
APIs could be "proto2" or "proto3".
URL is the private address for accessing the schema. This is not guaranteed to be publicly accessible and could be a non-HTTP protocol (i.e. gs:// or s3://)