POST
/
organisations
/
{organisationId}
/
schemas
/
{id}
/
publish
curl --request POST \
  --url https://api.switchboard.svc.versori.io/v1alpha1/organisations/{organisationId}/schemas/{id}/publish \
  --header 'Authorization: Bearer <token>'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "sourceUrl": "<string>",
  "type": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "version": "<string>"
}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organisationId
string
required

OrganisationID is the ID of the organisation that the schema belongs to.

id
string
required

ID is the schema identifier

Response

200 - application/json
createdAt
string
required
deletedAt
string
id
string
required
sourceUrl
string
required

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://)

type
string
required

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.

updatedAt
string
required
version
string
required

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".