---
schema_version: "1"
id: df6119667c0b3764e6f7f002de1209f7dd2edcc1f4ef962b1e0365ae2db8aa85
title: Submit an API Spec With a Relative URL
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/external_services_register_relative.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.external_services_register_relative.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 391949a44dada7b16da192458ab21082e15977f64672e7b932696bb8418880f7
description: Provide a relative URL to the spec.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Submit an API Spec With a Relative URL

Provide a relative URL to the spec.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d29106e72">User
              Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d29106e72 ">To manage connections: </td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d29106e72 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

To register an API spec using a relative URL:

1. From Setup in Lightning Experience, enter External Services in the Quick Find box, and select **External Services**.
2. Click **New External Service**.
3. On the Select an API Source page, select whether you’re importing an API spec **From Mulesoft Anypoint Platform**, or **From API Specification**. Since we're using our own spec in this example, select **From API Specification**.
4. For External Service Name, enter a unique service name.
5. Enter an optional description.
    
    A good, short description can help distinguish one service from another in a long list of services.
6. Click under **Select a Named Credential** and select a named credential from the list.
7. Under **Service Schema**, select **Relative URL**.
8. Enter a relative URL path to the schema (endpoint) under **URL**.
    
    It must begin with “/” and be a relative path. For example, `/accountSchema.json`.
9. If one or more errors are found during the validation process, a message (or series of messages) gives specific details about the error. You make corrections to the schema by editing it directly in the text editor and clicking **Validate** to revalidate your changes, or by modifying an offline copy and re-registering it. There are two types of errors:
    - Syntax or logical errors—_Must be fixed to complete the registration process_. To resolve an error, use the error message to discover the type and location of the error. Make corrections, and click **Validate**. Syntax error messages provide line and column number location.
    - Syntax or logical warnings—You don’t need to fix warnings to complete a registration. But the respective schema components are ignored by the External Services and aren’t registered. To fix warnings, use the guidance in the warning message, make corrections, and click **Validate**.
10. Click **Save & Next**.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/images/icon_note.png)
    
    Note 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](https://help.salesforce.com/s/articleView?id=platform.external_services_mime_type_mapping.htm&release=264.0.0&type=5).
11. Select the operations you want to import into your external service registration. You can select up to 3,000 _operations_ per org, and up to 3,000 active _objects_ per org. If you exceed either of these limits, divide the operations in your schema across separate registrations. For information about limits, see [External Services Considerations](https://help.salesforce.com/s/articleView?id=platform.enhanced_external_services_considerations.htm&release=264.0.0&type=5 "Here are the semantic, service, and usage constraints to keep in mind when integrating your services into External Services."). For information about “objects” in Open API schemas, see [Basic Structure (OpenAPI 2.0)](https://swagger.io/docs/specification/2-0/basic-structure/) and [Basic Structure (OpenAPI 3.0)](https://swagger.io/docs/specification/basic-structure/)
12. Click **Next**.
13. Click **Done**.