curl --request POST \
--url https://platform.versori.com/api/switchboard/v1alpha1/organisations/{organisationId}/apps/{appId}/operation-builder \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"schemaId": "<string>",
"id": "<string>",
"method": "GET",
"description": "<string>",
"name": "<string>",
"path": "<string>",
"request": {
"parameters": [
{
"name": "<string>",
"type": "string",
"location": "path",
"required": true
}
],
"body": {}
},
"response": {},
"callbacks": {},
"components": {}
}
'{
"schemaId": "<string>",
"id": "<string>",
"method": "GET",
"description": "<string>",
"name": "<string>",
"path": "<string>",
"request": {
"parameters": [
{
"name": "<string>",
"type": "string",
"location": "path",
"required": true
}
],
"body": {}
},
"response": {},
"callbacks": {},
"components": {}
}BuildSchemaOperationForApp validates and uses the schema builder to fill in any possible fields on a proposed new schema operation for an app.
curl --request POST \
--url https://platform.versori.com/api/switchboard/v1alpha1/organisations/{organisationId}/apps/{appId}/operation-builder \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"schemaId": "<string>",
"id": "<string>",
"method": "GET",
"description": "<string>",
"name": "<string>",
"path": "<string>",
"request": {
"parameters": [
{
"name": "<string>",
"type": "string",
"location": "path",
"required": true
}
],
"body": {}
},
"response": {},
"callbacks": {},
"components": {}
}
'{
"schemaId": "<string>",
"id": "<string>",
"method": "GET",
"description": "<string>",
"name": "<string>",
"path": "<string>",
"request": {
"parameters": [
{
"name": "<string>",
"type": "string",
"location": "path",
"required": true
}
],
"body": {}
},
"response": {},
"callbacks": {},
"components": {}
}OrganisationID is the ID of the organisation that the schema belongs to.
AppId is the app identifier
BuildSchemaOperationRequest contains the necessary parameters to build a new schema operation.
The ID of the schema this object belongs to.
The ID of the operation, for OpenAPI this will be the operationId field if set, otherwise the request's
type and path.
The http method that the operation uses.
GET, PUT, POST, DELETE, OPTIONS, HEAD, PATCH, TRACE, SQL A human-friendly description of what this operation does.
A human-friendly name based on the operation ID.
The path used to call the operation.
Show child attributes
Show child attributes
The name of the operation parameter.
The type of the operation parameter.
string, integer, number, boolean The location of the operation parameter.
path, query, header, cookie Whether the parameter is required.
The request body of the operation.
The response body of the operation.
The callbacks of the operation.
An optional map of components the operation refers to indexed by ref.
BuildSchemaOperationResponse is returned after a schema operation has been built.
The ID of the schema this object belongs to.
The ID of the operation, for OpenAPI this will be the operationId field if set, otherwise the request's
type and path.
The http method that the operation uses.
GET, PUT, POST, DELETE, OPTIONS, HEAD, PATCH, TRACE, SQL A human-friendly description of what this operation does.
A human-friendly name based on the operation ID.
The path used to call the operation.
Show child attributes
Show child attributes
The name of the operation parameter.
The type of the operation parameter.
string, integer, number, boolean The location of the operation parameter.
path, query, header, cookie Whether the parameter is required.
The request body of the operation.
The response body of the operation.
The callbacks of the operation.
An optional map of components the operation refers to indexed by ref.