Skip to main content
Reminix uses bearer tokens for authentication. There are three token types, each designed for a different use case.
Token TypePrefixScopeBest For
Project API Keyreminix_sk_Single projectServer-to-server, backend integrations
Personal Access Tokenreminix_pat_User-level, multi-projectCLI tools, personal scripts, development
Client Tokenreminix_ct_Restricted, short-livedFrontend apps, mobile clients

Project API Key

The primary authentication method. Scoped to a single project, passed in the Authorization header.
curl -X POST https://api.reminix.com/v1/agents/my-agent/invoke \
  -H "Authorization: Bearer reminix_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Hello"}}'
To get your API key:
  1. Sign in to the Reminix Dashboard
  2. Open your project settings
  3. Copy the API key from the API Keys section

Personal Access Token (PAT)

A user-level token that works across all projects your account has access to. You must include the X-Project header to specify which project to target.
curl -X POST https://api.reminix.com/v1/agents/my-agent/invoke \
  -H "Authorization: Bearer reminix_pat_..." \
  -H "X-Project: proj_..." \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Hello"}}'
PATs inherit your user permissions. If you lose access to a project, any PAT you hold will also lose access to that project.

Client Token

Short-lived, browser-safe tokens with restricted permissions. Create them server-side via the API, then pass them to your frontend.
// Server-side: create a client token
const token = await client.clientTokens.create({
  permissions: ["agents:invoke"],
  expires_in: 3600,
})

// Client-side: use the token
const clientReminix = new Reminix({ apiKey: token.token })
Client tokens:
  • Are created via POST /v1/client-tokens
  • Support scoped permissions (e.g., agents:invoke, agents:chat)
  • Auto-expire after the specified duration
  • Can be revoked via DELETE /v1/client-tokens/{id}

SDK configuration

import Reminix from "@reminix/sdk"

// Using a project API key
const client = new Reminix({
  apiKey: "reminix_sk_...",
})

// Using a personal access token
const client = new Reminix({
  apiKey: "reminix_pat_...",
  defaultHeaders: { "X-Project": "proj_..." },
})
Never expose project API keys or personal access tokens in client-side code. Use client tokens for browser and mobile environments.

Next steps

API Reference

Endpoint reference for invoke, chat, workflows, and connections.

Configuration & Secrets

Pass API keys and other secrets to your handlers at runtime.

Client Tokens API

Mint scoped, short-lived tokens for browsers and mobile clients.

Quickstart

Sign in, get your first key, and ship an agent in under five minutes.