TLNT Connect API

A key or connection only reaches what its scopes allow, and never more than the member it acts as can do in the app. New keys start with the default read scopes. High-risk scopes are never pre-selected.

Never available over the API: team role changes and member removal; invitations; API key and connector management; integration connects; billing and subscription; workspace settings; approving or rejecting Atlas actions; moving money (payouts, direct pay, refunds).

ask_atlas stays inside the key's other scopes: Atlas's tools, and the workspace context it is given, cover only what those scopes can read. Money needs finance:read on an admin's key. Saved agency memory reaches Atlas only on an admin key with finance:read, because notes can hold rates and fees.

Everything a key or connected app is granted runs directly, within its daily caps. A workspace admin can set any class below to Ask for approval in TLNT, per API key or per connected app: the call then answers 202 with status: "pending_approval" and an action_id; poll get_action (GET /api/v1/actions/{action_id}) until it is executed, rejected, failed or expired. Nothing can be approved or rejected over the API.

• Every class defaults to Run directly, for API keys and connected apps alike. Past a daily cap the call answers 429 and nothing runs.
• Written confirmation in chat: send_invoice, request_agreement_signature, send_creator_message. The first call sends nothing and answers 200 with status: "confirmation_required", the exact preview and a confirmation_token. Show the preview to the user; only after they confirm it in writing, call again with the same arguments and the token (single use, 10 minutes). It then sends once.
• What Atlas does during ask_atlas follows the same settings and is listed in its result.

• Paid Discovery calls spend Discovery credits at the app's rate card. Call the free preflight first; it returns the price and a quote_token (5 minutes) for the paid call. An empty creator report is charged like the app.
• ask_atlas uses one Atlas run credit; inbox summaries and drafts use one Atlas credit each. Both come from the workspace's monthly Atlas allowance.
• Free: Competitor tracked, Creative direction, Outreach email (no credits; the daily recipient cap still applies).

{ "error": { "code": "missing_scope", "message": "…", "issues": [ … ], "retry_after_seconds": 30 } }

• code is stable; message is for people. issues lists invalid input fields (400).
• Retry-After comes with 429 rate limits and daily caps, 409 in-progress retries, 503, and every 202.
• Writes accept an Idempotency-Key header (MCP: idempotency_key); the same key and request within 24 hours replays the stored response with Idempotent-Replayed: true.
• An MCP tool error is a tool result with isError: true and the same JSON body.

163 operations, generated from /api/v1/openapi.json (OpenAPI 3.1). Each REST operation is also an MCP tool of the same name. Open an operation for its inputs, responses and rules.