> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post organisations schemas publish

> PublishSchema publishes an existing schema.



## OpenAPI

````yaml post /organisations/{organisationId}/schemas/{id}/publish
openapi: 3.0.3
info:
  title: Switchboard API
  description: >-
    The Switchboard API provides users the ability to manage their Apps,
    Integrations and Workflows
  version: 0.0.1-alpha.0
servers:
  - url: https://platform.versori.com/api/switchboard/v1alpha1/
    description: Production server
  - url: http://localhost:8080/v1alpha1/
    description: Localhost
security:
  - apiKey: []
paths:
  /organisations/{organisationId}/schemas/{id}/publish:
    post:
      tags:
        - schemas
      description: PublishSchema publishes an existing schema.
      operationId: PublishSchema
      parameters:
        - name: organisationId
          in: path
          required: true
          schema:
            type: string
          description: >-
            OrganisationID is the ID of the organisation that the schema belongs
            to.
          examples:
            postman:
              summary: Use as a variable in a Postman request
              value: '{{organisationId}}'
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID is the schema identifier
          examples:
            postman:
              summary: Use as a variable in a Postman request
              value: '{{schemaId}}'
      responses:
        '200':
          $ref: '#/components/responses/PublishSchemaResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
components:
  responses:
    PublishSchemaResponse:
      description: >
        PublishSchemaResponse is the response containing the Schema of a
        published schema.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Schema'
    ErrorResponse:
      description: The default error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Schema:
      type: object
      properties:
        id:
          type: string
        type:
          description: >
            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.
          type: string
        version:
          description: >
            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".
          type: string
        sourceUrl:
          description: >
            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
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        deletedAt:
          type: string
          format: date-time
      required:
        - id
        - type
        - version
        - sourceUrl
        - createdAt
        - updatedAt
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        extensions:
          type: object
      required:
        - code
        - message
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization

````