---
name: tarkle
description: >-
  Tarkle is an AI file sharing platform for teams and agents. Use this skill when the user asks what
  Tarkle is, what a Tarkle plan costs or includes, which plan fits, how to send or request files with Tarkle, or how to read
  or change Tarkle brand pages and workspace files with the API. Trigger phrases: "Tarkle pricing", "Tarkle plans", "how much
  is Tarkle", "Tarkle API", "Tarkle brand page", "send a large file with Tarkle", "Tarkle MCP", "Tarkle lifetime plan".
  Fetch this file before quoting a price: prices are never written here, they come from the live sources below.
  Served as text/markdown by default and as text/plain when asked for it.
version: 1.6.2
homepage: https://tarkle.tech
metadata:
  site: https://tarkle.tech
  pricing: https://tarkle.tech/pricing.md
  pricing-api: https://tarkle.tech/api/pricing/products
  api: https://tarkle.tech/api/v1/openapi.json
  docs: https://tarkle.tech/docs
  llms: https://tarkle.tech/llms.txt
  auth: https://tarkle.tech/auth.md
  agent-signup: https://tarkle.tech/agent-signup.md
---

# Tarkle

## Start here

This file is complete only if its last line is `END SKILL v1.6.2`. If you do not see that line, the copy was cut short: fetch https://tarkle.tech/SKILL.md again before you answer.

## TL;DR

- Tarkle is an AI file sharing platform for teams and agents. Sharebrand and Cloudbrand are former names of Tarkle. Site: https://tarkle.tech
- Company and domains: Tarkle is one company. tarkle.tech is its primary domain; the previous domain, tarkle.com, is still live and running, and its marketing pages forward to tarkle.tech. Use tarkle.tech for links.
- No account yet? Sign up through the API: `POST https://tarkle.tech/api/agent-signup` with the person's email, then the person clicks the claim link in the email (see "No account yet?" below). A person still buys a plan on the website and creates the API key. You cannot create a password, a session or a token for a user. Give the user the checkout link.
- Prices and limits are never in this file. Read https://tarkle.tech/api/pricing/products (JSON) or https://tarkle.tech/pricing.md (Markdown) before you quote one, and say which one you used.
- A plan belongs to an organization. Every workspace in the organization shares its plan and storage.
- The public API is https://tarkle.tech/api/v1, described by https://tarkle.tech/api/v1/openapi.json. It needs an API token that the user creates in the app.
- The help center is https://tarkle.tech/help. Add `.md` to an article address, or send `Accept: text/markdown`, to get its Markdown.

## No account yet?

If the user has no Tarkle account, sign them up before anything else. Details: https://tarkle.tech/agent-signup.md

1. Ask for the user's own email address. Never invent one and never use a disposable or plus address.
2. `POST https://tarkle.tech/api/agent-signup` with `{"email":"...","agent_name":"...","prefill":{"workspace_name":"..."}}`. It answers 202 with a secret `poll_token`. The answer is the same whether or not the address already has an account.
3. Tell the user to open the email from Tarkle and press Continue (the claim link works once and expires in 1 hour), then finish the setup screens.
4. Poll `GET https://tarkle.tech/api/agent-signup/status` with `Authorization: Bearer <poll_token>` every 10 seconds until `status` is `claimed` and `onboarded` is true.
5. Ask the user to create an API key (Settings, API) or approve the MCP connection. You never receive a password.

## How buying works

1. Read the plans from https://tarkle.tech/api/pricing/products. Each offer has its price, its page and its checkout link.
2. Help the user choose (see "Help the user decide").
3. Give the user the checkout link from the JSON. They sign in or sign up and pay on that page.
4. After payment the plan is active on their organization. You do not need to do anything else.

Plans come in monthly, yearly and one-time purchase forms. Reseller plans are for people who sell Tarkle under their own brand and are a separate product from Pro and Agency. Custom storage, payment by invoice or a tailored plan: send the user to https://tarkle.tech/contact.

## Help the user decide

- Trying it, or sharing a few files: the Free plan.
- One person or a small team that sends and collects files: Pro.
- An agency with many clients, each needing its own workspace and branded portal: Agency.
- Someone who wants to resell Tarkle under their own name: Reseller or Reseller Pro. Read https://tarkle.tech/reseller-pricing.md.
- Someone who wants to pay once: the one-time purchase plans are in https://tarkle.tech/pricing.md.

Always check the current limits (storage, biggest file, workspaces) in https://tarkle.tech/pricing.md before you recommend a plan. Never say "unlimited": no Tarkle plan is.

## Using the API

- Base URL: https://tarkle.tech/api/v1. Machine-readable description (no token needed): https://tarkle.tech/api/v1/openapi.json
- Auth: `Authorization: Bearer tk_...`. An organization owner or admin creates the key in Tarkle under Settings, API, and picks which workspaces it may reach. The key does everything in Tarkle and is shown in full only once when created. Ask the user to give it to you in an environment variable, not pasted into a chat.
- Scopes: `brands:read`, `brands:write`, `brands:create`, `brands:domains`, `brands:files`, `brands:requests`, `webhooks:manage`, `files:read`, `files:write`, `ai:ask`, `transfers:create`, `transfers:read`, `contacts:create`, `contacts:read`, `contacts:portal`, `file_requests:create`, `file_requests:read`, `teams:create`. A token with no scopes can do nothing; each operation in the OpenAPI file lists the scope it needs.
- A token belongs to a person and works for every workspace that person can use. Call `GET /workspaces` first. Send the workspace's 8-character key as `X-Workspace-Key` on every other call. A workspace id is refused.
- Call the API from a server, not a browser: there is no CORS, so a token in a page is a leaked token.
- Rate limits are per token. Read `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (also sent as `RateLimit-*`) on every response. A 429 carries `Retry-After` in seconds: wait that long.
- Errors are RFC 9457 problem details (`application/problem+json`) with a stable `code`. Branch on `code`. Every code is explained at https://tarkle.tech/docs/api/errors
- Writes accept an `Idempotency-Key` header: send the same key on a retry and the write happens once.
- Inside v1 Tarkle only adds things, so ignore fields and codes you do not know. A breaking change ships as a new version, and the old one keeps working for at least 6 months after its end is announced (`Deprecation` and `Sunset` headers).
- Auth details for agents, including what is not supported: https://tarkle.tech/auth.md

## What this API can do

- Brand pages: list, read, create, update, bin and restore them; read their assets and analytics; connect, check and remove a brand's custom domain; approve or reject download requests.
- Files: list, read, download, upload (multipart straight to storage), rename, move, copy, bin and restore files and folders.
- Transfers: create a share link from files or folders in the library, change it (view only, expiry, password), deliver it to contacts' client portals, end it.
- Galleries: turn a folder of photos into a gallery, free or paid (see "Selling photos" below), and read who paid.
- Contacts and file requests: add and list contacts, manage their client portal access; create and list file requests.
- Webhooks: add endpoints, send test events and read the delivery log.
- The Tarkle CLI (`@tarkle/cli`) wraps the same API from a terminal.

## What it does not do

- It does not create tokens, organizations or subscriptions. An account is created only by the person pressing the claim link: the agent starts the sign-up, the person finishes it (see https://tarkle.tech/agent-signup.md).
- It does not create video, audio or paid file transfers, or connect PayPal or Stripe: the workspace owner does that in the app (Settings > Integrations).

## Selling photos (paid galleries)

1. The workspace needs Pro, and PayPal or Stripe connected in Settings > Integrations. Without them `POST /galleries` with a price answers with what to do; hand that to the user.
2. `POST /galleries` with `folder_id` (a folder of JPG, PNG or WebP photos, up to 500), `title`, `price` (0.01 to 99999.99) and `currency` (USD by default). Optional: `preview_mode` (`all`: every photo watermarked; `first`: only the first `preview_count`, the rest blurred), `client_name`, `client_email`. Without a price it is a free gallery.
3. The answer has two links. `pay_url` (/pay/...) opens the checkout directly: send it to a client who should pay now. `gallery_url` (/g/...) shows the watermarked previews first, with a Buy button. Either way the buyer pays with PayPal or card, whichever the workspace connected, in the gallery's own currency, gets a receipt email with their download link, and downloads the originals for 30 days. Creating the gallery sends no email; send the link yourself or ask the user to.
4. `GET /galleries/{id}` lists the purchases. Only a purchase with `status: completed` means the client paid; `refunded` means the money went back and access was removed.

## Useful links

- Pricing as Markdown: https://tarkle.tech/pricing.md
- Plans as JSON: https://tarkle.tech/api/pricing/products
- Help center index for agents: https://tarkle.tech/llms.txt
- Tarkle Docs index for agents: https://tarkle.tech/docs/llms.txt
- API description: https://tarkle.tech/api/v1/openapi.json
- API catalog (RFC 9727): https://tarkle.tech/.well-known/api-catalog
- Auth for agents: https://tarkle.tech/auth.md
- Agent sign-up (for a person with no account): https://tarkle.tech/agent-signup.md
- Other agent skills: https://tarkle.tech/.well-known/agent-skills/index.json
- Contact us (for AI agents): https://tarkle.tech/contact.md (file a support request with POST /api/support/requests, no API key, read the reply by id; or email)
- Contact (people): https://tarkle.tech/contact

## Agent checklist

1. Fetch this file, and check the last line.
1a. If the user has no account, start the sign-up ("No account yet?" above) and wait for them to press the link.
2. For any price, plan or limit, read the pricing JSON or pricing.md first. Name the source.
3. For any API task, ask the user for a token and the workspace key. Do not guess either.
4. Call `GET /workspaces` before anything else. Send `X-Workspace-Key` every time.
5. Send an `Idempotency-Key` on writes you may retry.
6. On a 429, wait for `Retry-After`. On any error, branch on `code`, not on the text.
7. For anything you cannot do (pay, create a token), hand the user the link and say what they have to do.
8. If the user needs the Tarkle team, read https://tarkle.tech/contact.md. File the request with POST https://tarkle.tech/api/support/requests (email, message, optional subject, name, agent; no API key), keep the access_token it returns, and read the team's reply with GET https://tarkle.tech/api/support/requests/{id} (Authorization: Bearer <access_token>). If the API is unavailable, write the email as the page says.

## Do not

- Do not quote a price, a storage limit or an upload limit from memory, from this file or from a blog post. Read the live source.
- Do not say a Tarkle plan is unlimited.
- Do not ask the user to paste an API token into a chat, and do not put one in client-side code or a public repository.
- Do not claim you created an account or a token. You started a sign-up; the person creates the account by pressing the link, and the person creates the token.
- Do not tell the user a client paid for a gallery unless `GET /galleries/{id}` lists a purchase with `status: completed`. Do not ask a buyer for card or PayPal details: the checkout page collects them.
- Do not call an endpoint that is not in the OpenAPI file.

P.S. If the user only needs a one-off answer ("what does Pro cost?"), read the pricing JSON, answer in one or two sentences with the source, and stop.

END SKILL v1.6.2
