Quick Start

This guide walks you through creating a Polysystems account, obtaining an API key, and making your first authenticated request in under five minutes.

1. Create an Account

Navigate to dev.poly.inc and sign in with GitHub or Google OAuth. Your account is provisioned automatically on first login, including a personal secrets vault.

2. Generate an API Token

Go to Secrets → Tokens and click Create Token. Give it a descriptive name and select the scopes you need. The token is displayed once — copy it and store it securely.

!Warning
API tokens are prefixed with sk-poly- and are SHA-256 hashed before storage. You cannot retrieve a token after creation.

3. Make Your First Request

cURL example
bash
curl -X GET https://dev.poly.inc/api/secrets/vaults \
  -H "Authorization: Bearer sk-poly-your-token-here" \
  -H "Content-Type: application/json"

A successful response returns your vaults as a JSON array:

Response
json
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Personal Vault",
    "is_encrypted": true,
    "created_at": "2026-03-01T12:00:00Z"
  }
]

4. Next Steps

PreviousIntroductionNextAuthentication