Define a REST API schema

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 1 Minute Lesedauer

    • Specify the expected data structure for requests or responses within a REST API by defining a schema.

    Vorbereitungen

    Role required: web_service_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Schemas are records that define the structure and format of request and response bodies and headers for a REST API in the OpenAPI 3.0.1 format. When you define a schema in the ServiceNow AI Platform, the schema is used to define the structure of requests and responses within the associated REST API. The schema data for the requests and responses is then available in the exportable OpenAPI specification for the API. For more information about exporting OpenAPI specifications, see Export to OpenAPI specification.

    Prozedur

    1. Create a REST Schema in one of the following ways.
      OptionProcedure
      Navigate through a scripted REST API record
      1. Navigate to All > System Web Services > Scripted REST APIs.
      2. Select a scripted REST API record.
      3. In the Schemas related list, select New.
      Navigate directly to a new REST Schema record
      1. Navigate to All > Filter and enter sys_ws_schema.form.
      2. In the API field, select or enter the API to associate with the schema.
    2. In the Name field, enter a name for the schema.
    3. In the Schema field, define the data type and structure of the new schema using the OpenAPI version 3.0.1 format.
      For example, the following entry specifies that the schema is an object that contains a first name. The first name is a string data type.
      { "type": "object", "properties": { "firstName": { "type": "string" } } }
    4. Select an OpenAPI version.
    5. In the Description field, summarize the expected structure of the new schema.
    6. Select Submit.

    Nächste Maßnahme

    Define additional schemas as needed. Use the schemas to specify the expected structure and format in a REST request or response. For more information, see Define an API resource request structure or Define an API resource response structure.