Share and Encrypt Text

POST

https://www.konfidant.app/api/v1/texts

Share and encrypt a text message with a specified time-to-live (TTL).

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

textstringRequired

ttl_hoursintegerRequired

Created

text_idstring

share_urlstringformat: "uri"

expires_atstring

verified_burnboolean

400

Bad Request Error

401

Unauthorized Error

1	const url = 'https://www.konfidant.app/api/v1/texts';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"text":"Secret message here","ttl_hours":168}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"text_id": "9140b841-4f00-......",
3	"share_url": "https://download.konfidant.app?t=hvs.CAESIK3EMh.......",
4	"expires_at": "2026-05-05 22:57:13",
5	"verified_burn": true
6	}