> For the complete documentation index, see [llms.txt](https://mediamarkup.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mediamarkup.gitbook.io/docs/api/endpoints.md).

# Endpoints

Please find additional documentation here on endpoints that might not be available at <https://api/mediamarkup.com/api-docs>

## CreatePersonalUrl

<mark style="color:green;">`POST`</mark> `https://api.mediamarkup.com/api/v1/Approvals/CreatePersonalUrl`

Creates a secure personal url for the specified userId and approval/comparison id and versions. PersonalUrls are time limited and must be created immediately before redirecting a user.\
\
The PersonalUrl will authenticat the user and redirect them to the annotation tool. If the uesr is not authorized, the authentication url will redirect the user to a login page or the RedirectUrl configured, with the following **redir** url parameters; \
\
NotAuthenticated - User/Tenant/Authenticatiuon token is not valid or authenticated \
\
AuthenticationExpired - if the expiry date within the validation token has expired.\
\
UserLoggedOut - User logged out via the Logout button

#### Request Body

| Name       | Type   | Description                                                                                                                        |
| ---------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| parameters | object | { "userId": "string", "approvalId": "string", "version": 0, "compareApprovalId": "string", "compareVersion": 0, "observer": true } |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "url": "string",
  "hasErrors": true,
  "messages": [
"string"
 ]
}
```

{% endtab %}
{% endtabs %}