# Endpoints

{% hint style="info" %}
**Use Case**

* Required for marking a request component as optional for mock response matching
  {% endhint %}

## Types of Endpoints

### Fixed Endpoint

A fixed endpoint has a static path that will exactly match a request's path.

* Matching against a fixed endpoint has the highest priority level

### Aliased Endpoint

An aliased endpoint has one or more aliases in its path. When an endpoint is aliased, fuzzy matching is applied when grouping requests.

* Matching against an aliased endpoint has lower priority than matching against a fixed endpoint
* Aliased endpoints with a lower number of aliased path segments will have higher matching priority over aliased endpoints with a higher number of aliased path segments

## Examples

Given the following endpoint patterns:

1. `/users/1`
2. `/users/:userId`
3. `/:organizationId/:userId`\\

### Example 1

A request with path `/users/1` will be grouped into **endpoint 1** because it is a fixed endpoint.

### Example 2

A request with path `/users/2` will be grouped into **endpoint 2** (one aliased path component) and not endpoint 3 (two aliased path components) because it has a lower number of aliased path components.

### Example 3

A request with path `/stoobly/2` will be grouped into **endpoint 3**

## **How To Create**

### Method 1

In the top right corner of the endpoints page, select the plus icon button.

<figure><img src="https://3980092275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLvhXOE-py5MDUOXDKD%2Fuploads%2Fgit-blob-0761cde6a892dd7086b441b39fdd0d44db79b461%2Fendpoints-index-empty.PNG?alt=media" alt=""><figcaption><p>Endpoints Page</p></figcaption></figure>

### Method 2

On the requests page, right-click a request and in the dropdown menu, select **Make Endpoint**.

<figure><img src="https://3980092275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLvhXOE-py5MDUOXDKD%2Fuploads%2Fgit-blob-4a193f1e324e052f245571453a8dee8d0c3e3a7a%2Frequests-page-dropdown.PNG?alt=media" alt=""><figcaption><p>Requests Page Dropdown</p></figcaption></figure>
