For an existing External Services registration, you can update the current schema with a new version.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, Unlimited, and Developer Editions |
To update the schema of an existing registration.
- From Setup in Lightning Experience, enter External Services in the Quick Find box, and select External Services.
- Click the arrow in the service’s Actions column, and select Edit.
- On the Select an API Source page, select whether you’re importing an API spec From Mulesoft Anypoint Platform, or From API Specification.
- Update the named credential, if necessary.
- If your schema includes operations that aren’t supported, you can filter them out by toggling on Only include supported operations (default). To learn why operations can't be included and to show errors, toggle it off. Toggling it off and showing errors is useful when you’re troubleshooting your API spec. For example, it can help identify wrong data types, undefined object references, and wrong or invalid OpenAPI attributes. If you aren’t sure, leave it toggled on.
- Enter a schema URL path (or endpoint) that points to the updated schema, or provide the complete, updated schema. If you enter a schema URL path, it must begin with “/” and be a relative path. For example, /accountSchema.json. If you provide a schema, it must be complete, valid OpenAPI 2.0 or 3.0, and JSON or YAML compliant.
- Click Save and Next. If your schema includes non-supported media types, the system displays the Associate operations with supported media types page. Select a valid mapping for each non-supported type, as described in Mapping Media Types during Registration.
- Select the operations you want to import into your external service registration, or deselect the ones you want to delete.
- Click Next.
- Click Done.