Developer API

TinySharp API Documentation

Connect TinySharp image optimization to WordPress, internal tools and custom workflows through a secure API key from your dashboard.

Open dashboard View WordPress plugin

Base endpoint

https://tinysharp.com/wp-json/sio/v1

Authentication

Use your dashboard API key in the X-TinySharp-Key header or as a Bearer token. Keep keys private and rotate them if exposed.

Token usage

Every successful optimization request uses account tokens. Token totals and remaining usage are available from the dashboard and token endpoint.

WordPress connector

The connector plugin uses the same API URL and key to optimize Media Library images, track savings and preserve backups.

Authentication

Copy your API key from My Dashboard and send it with each request. Header authentication keeps credentials out of URLs and server logs.

X-TinySharp-Key: tsh_live_your_key
Authorization: Bearer tsh_live_your_key

Token status

Use the token endpoint to check the active plan and remaining optimization credits for the API key.

GET /wp-json/sio/v1/tokens
X-TinySharp-Key: tsh_live_your_key

Optimize an image

Send an image file with quality and output format options. The API returns optimized image data, metadata and remaining token information.

POST /wp-json/sio/v1/optimize
Content-Type: multipart/form-data
image=@photo.jpg
quality=82
output_format=webp

Common responses

401 means the API key is missing or invalid. 402 means there are not enough tokens. 415 means the file type is not supported. 429 may be used for rate limits.

API docs

Developer experience

Clean API access for real image workflows

TinySharp keeps the API flow simple: copy a key from the dashboard, connect the plugin or your own integration, and track usage from one account area.

Header-based API key authentication keeps credentials out of URLs.
Token status responses make account usage clear.
The same endpoint powers the WordPress connector and direct API workflows.

API keyToken statusOptimize endpointWordPress connector

FAQ

Questions about the TinySharp API

These answers cover the production API workflow used by the dashboard and connector.

Where do I get an API key?

Should I put the API key in a URL?

No. Use the X-TinySharp-Key header or Authorization Bearer header so private credentials are not exposed in URLs.

What endpoint does the WordPress plugin use?

The connector uses the TinySharp API URL shown in the dashboard, normally /wp-json/sio/v1 on the TinySharp host site.

Can I rotate my key?

Yes. Rotate it from My Dashboard, then update every connected WordPress site or integration that uses the old key.

TinySharp API Documentation

Authentication

Token usage

WordPress connector

Authentication

Token status

Optimize an image

Common responses

Clean API access for real image workflows

Questions about the TinySharp API

Connect your first WordPress site