---
title: "Create share link"
method: POST
path: "/v1/sharelink"
tags: ["Sharelinks"]
---

# Create share link

`POST /v1/sharelink`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/sharelink`
- Auth: HTTP bearer

**Auth**: User JWT

sharelink creation

## Request body

- object
  - `expiration` number: Unix-epoch timestamp (seconds) when this share link stops working. Omit for a non-expiring link.
  - `memo` string: Free-form description shown to recipients alongside the link. Up to ~500 characters.
  - `resource` string: The thing being shared, as either a chat name (`<appId>_<chatId>`) or a fully-qualified MUC JID.

## Response `200`

```
   {sharelinkData: {
     userId: string,
     walletAddress: string,
     expiration: string,
     token: string,
     targetRecordId: string,
   }}
```

- SharelinkCreateResponse
  - `sharelinkData` SharelinkRecord, required
    - `userId` string
    - `walletAddress` string
    - `expiration` number
    - `memo` string, nullable
    - `resource` string
    - `token` string
    - `targetRecordId` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Validations error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)