SaltingIO Documentation

How SaltingIO Works

Reference for credentials, bridges, batch API, transformation, and the Playground.

Quick Start

1

Create Account

Sign up for a free account to start encrypting your data

2

Add Secret

Create a Credential (encrypted static data) or a Bridge (proxy to an external URL).

3

Access via API

Use the record URL (e.g. /r/{uuid}) with GET, or send custom headers for private credentials.

Core Concepts

AES-256-GCM Encryption

All data stored in SaltingIO is encrypted using industry-standard AES-256-GCM encryption. This provides both confidentiality and integrity protection.

256-bit encryption keys
Authenticated encryption
Zero-knowledge architecture

Access Control

Control who can access your data with flexible privacy settings and optional password protection.

Public: no authentication
Private: password in request body, or X-API-Key header for programmatic access
Owner-only: dashboard-only access

Credential vs Bridge

Credential

Encrypted static data stored at rest. You provide the plaintext (e.g. API key, config); it is encrypted client-side and stored. Access returns a JSON body with a single data field containing the decrypted payload, or base64-encoded ciphertext depending on access method.

Response format

{ "data": "<string>" }

For programmatic access with X-API-Key, the value may be base64-encoded; decode to obtain the plaintext.

  • • API keys, tokens, connection strings
  • • Optional password or X-API-Key for private records

Bridge

A proxy to an external URL. SaltingIO forwards requests to your destination URL and returns the upstream response. The Bridge URL is public; the upstream API key or auth is stored as headers (Authentication & Headers) and sent only server-side.

Bridge options

  • Allowed HTTP methods: restrict which methods (GET, POST, etc.) the bridge accepts.
  • Allowed origins: optional CORS allowlist (e.g. https://myapp.com).
  • Authentication & Headers: HTTP headers to forward with every request to the upstream URL (e.g. Authorization, X-API-Key).
  • • Live APIs, webhooks, backend services
  • • Template variables in the destination URL; parameters passed as query params

Advanced Features

Template Variables (Parameters)

For Bridges (and credentials with parameters), define named parameters (e.g. ticker, city) and use {{variable}} in the stored URL or data. Callers pass values as query parameters; they are substituted before the request is executed. Parameter names are case-sensitive.

Example:

Stored data:
https://api.example.com/data?symbol={{ticker}}&secret_key=••••••••
Access URL:
https://api.salting.io/r/550e8400-e29b-41d4-a716-446655440000?ticker=AAPL
Result:
https://api.example.com/data?symbol=AAPL&secret_key=••••••••

Response Transformation (select)

For Bridges (and single-record requests), you can reshape the response using a select query parameter. The value uses GJSON-style paths.

Single path

Return one field, e.g. current.temp_c.

Object form

Map output keys to paths: {temp:current.temp_c,city:location.name}.

Example

GET /r/{uuid}?select={temp:current.temp_c,city:location.name}

Failover URLs

Provide backup URLs that SaltingIO will try if the primary URL fails. Ensures high availability and reliability for your endpoints.

How it works:

1
Try primary URL
2
If failed, try backup URL #1
3
If failed, try backup URL #2
4
If all fail, show custom message

Playground

Test Your Endpoints

The Playground (dashboard → Playground) lets you call your records without writing code. Test Credentials and Bridges, try different HTTP methods, and inspect responses.

Single request

Select a secret, choose method (GET, POST, PUT, PATCH, DELETE), and set URL parameters, custom headers (e.g. X-API-Key), or a JSON body. Use the Transformation tab to build a select string by clicking response fields.

Params, Headers, Transformation

Batch request

Send one POST /batch with multiple items. Each item has uuid, optional params, and optional select. Response is an array in the same order.

Multiple records in one call

Credentials

Credential responses are JSON with a data field. With X-API-Key the value may be base64-encoded. Use "Decrypt Base64" in the Playground to decode data in the UI.

Copy body, decode base64

Team Management

Collaborative Data Management

SaltingIO's team management system enables secure collaboration on encrypted data. Create teams, invite members, and manage access with granular role-based permissions.

Team Operations

Create and manage teams
Join teams with team IDs
Secure team data sharing

Role-Based Access

A
Admin - Full team management
E
Editor - Create and edit secrets
V
Viewer - Read-only access

Create Teams

Set up new teams with custom names and invite members using secure team IDs.

Team ID Example:
68deab1e5b7d051eb85a5463

Member Management

Invite members, assign roles, and manage permissions with granular access control.

Role-based permissions
Easy member invitation

Team Secrets

Collaborate on encrypted secrets with team-specific access and permissions.

Encrypted team data
Permission-based access

Team Collaboration Workflow

1

Create Team

Set up a new team with a custom name

2

Invite Members

Share team ID to invite collaborators

3

Assign Roles

Set appropriate permissions for each member

4

Collaborate

Work together on encrypted team secrets

API Reference

Single record

GET|POST|PUT|PATCH|DELETE to https://api.salting.io/r/{uuid}. Bridges respect allowed methods; credentials are typically GET. Send custom headers (e.g. X-API-Key, Content-Type).

URL
https://api.salting.io/r/550e8400-...

Query

  • param=value — template variables
  • select=path or select={key:path}

Auth (private)

X-API-Key header or password in body.

Credential response

Success returns JSON with one field data (string). With X-API-Key the value may be base64; decode to get plaintext.

{ "data": "<string>" }

Batch

POST /batch with a requests array. Response order matches request order. Requires auth (e.g. session cookie).

Body
{ "requests": [
  { "uuid": "..." },
  { "uuid": "...", "params": {}, "select": "..." }
] }
  • uuid — required
  • params — optional
  • select — optional

Security & Privacy

Zero Knowledge

We cannot read your encrypted data. Only you have the keys to decrypt your information.

End-to-End Encryption

Data is encrypted on your device before transmission and stored encrypted on our servers.

Privacy First

We don't track your usage patterns or store any personal information beyond what's necessary.

Ready to Get Started?

Join thousands of developers and businesses who trust SaltingIO to secure their sensitive data.

Contents

SALTING

IMPORTANT DISCLAIMER: SaltingIO LLC provides a proxy service that routes API requests through our global network. Service is provided 'AS IS' without warranties of any kind. Users are solely responsible for complying with all third-party API terms, applicable laws, and regulations in their jurisdiction. We do not guarantee service availability, uptime, performance, or control over external API providers. Service may be subject to rate limits, regional restrictions, and modifications without notice. Our liability is limited as set forth in our Terms of Use. By using our service, you acknowledge and agree to our Terms of Use and Privacy Policy, including binding arbitration and class action waivers.

© 2026 SaltingIO LLC. All rights reserved.