ETERA API Documentation

Unsubscribe one or more device tokens from a Firebase topic.

Features:

Bulk unsubscription of multiple tokens
Success/failure count for each operation
Idempotent operation (safe to retry)
Graceful handling of non-existent subscriptions

Use Cases:

User preference changes
App uninstallation cleanup
Topic management and maintenance
Privacy compliance (opt-out)

Behavior:

Unsubscribing from non-existent topics succeeds
Invalid tokens are reported in failure count
Partial failures still process valid tokens

Unsubscribe one or more device tokens from a Firebase topic. **Features:** - Bulk unsubscription of multiple tokens - Success/failure count for each operation - Idempotent operation (safe to retry) - Graceful handling of non-existent subscriptions **Use Cases:** - User preference changes - App uninstallation cleanup - Topic management and maintenance - Privacy compliance (opt-out) **Behavior:** - Unsubscribing from non-existent topics succeeds - Invalid tokens are reported in failure count - Partial failures still process valid tokens

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Request

This endpoint expects an object.

tokenslist of stringsRequired

topicstringRequired

Response

This endpoint returns an object.

successboolean

dataobject

errorobject

1	const url = 'https://api.etera.dev/notification/push/topic/unsubscribe';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"tokens":["string"],"topic":"string"}'
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	"success": true,
3	"data": {
4	"successCount": 1.1,
5	"failureCount": 1.1
6	},
7	"error": {
8	"message": "string",
9	"code": "string"
10	}
11	}