# Langsys API Documentation

> Langsys is a translation and localization management platform. This document provides an overview of the Langsys REST API.

## API Reference

- [Full API Documentation (Markdown)](https://docs.langsys.dev/llms-full.txt): Complete API reference in LLM-friendly markdown
- [Integration API Documentation (Markdown)](https://docs.langsys.dev/llms-integration.txt): The API-key-accessible subset only, in LLM-friendly markdown — start here to integrate
- [OpenAPI Specification (JSON)](https://api.langsys.dev/api/docs/api-docs.json): Full machine-readable API specification (OpenAPI 3.0)
- [Interactive API Reference](https://docs.langsys.dev/api/): Scalar-powered interactive API documentation
- [Interactive Integration Reference](https://docs.langsys.dev/integration/): Scalar docs scoped to the API-key-accessible endpoints

## Laravel & PHP packages

Open-source Composer packages at https://docs.langsys.dev/packages — translation SDKs plus the Laravel toolkit extracted from the Langsys API.

- [Package catalog](https://docs.langsys.dev/packages): all published `langsys/*` packages
- Translation: [Laravel SDK](https://docs.langsys.dev/packages/langsys-php-laravel) (`langsys/langsys-php-laravel`), [PHP SDK](https://docs.langsys.dev/packages/langsys-php) (`langsys/langsys-php`)
- Laravel toolkit: [Access Guard](https://docs.langsys.dev/packages/laravel-access-guard), [API Keys](https://docs.langsys.dev/packages/laravel-api-keys), [Request Query Cache](https://docs.langsys.dev/packages/laravel-request-query-cache), [OpenAPI Docs Generator](https://docs.langsys.dev/packages/openapi-docs-generator)
- Packagist vendor: https://packagist.org/packages/langsys/

## Learning Center (SDK documentation)

Interactive SDK docs at https://docs.langsys.dev/learn — the model: the phrase in your code is both the lookup key and the base-language default; no keys file, no extraction step.

- [Quickstart](https://docs.langsys.dev/learn/quickstart): Create a project and mint a write key (development) + read-only key (production)
- [Concepts](https://docs.langsys.dev/learn/concepts): How Langsys works, token discovery, the locale store, keys & environments
- Frontend SDKs: [TypeScript](https://docs.langsys.dev/learn/sdk/typescript), [React](https://docs.langsys.dev/learn/sdk/react), [Vue](https://docs.langsys.dev/learn/sdk/vue), [Svelte](https://docs.langsys.dev/learn/sdk/svelte)
- Backend SDKs: [PHP](https://docs.langsys.dev/learn/sdk/php), [Laravel](https://docs.langsys.dev/learn/sdk/laravel)
- Framework guides: [Next.js](https://docs.langsys.dev/learn/guides/nextjs), [Nuxt](https://docs.langsys.dev/learn/guides/nuxt), [SvelteKit](https://docs.langsys.dev/learn/guides/sveltekit)
- [Troubleshooting](https://docs.langsys.dev/learn/troubleshooting): Symptoms, causes, and fixes for the failure modes integrators actually hit

## API Overview

The Langsys API is organized around REST. It uses bearer token authentication and returns JSON responses.

Base URL: https://api.langsys.dev

### Authentication
- **Bearer Token**: Pass your token in the Authorization header as `Bearer <token>`
- **API Key**: Use an API key for project-scoped access

### Resource Groups

- **API Key**: Create, list, update, and delete API keys for project access and authentication
- **API Key - Reports**: Activity tracking and historical reporting for API keys
- **Auth**: User registration, login, account activation, and email verification
- **Invitation**: Send, accept, decline, and revoke user invitations
- **Invoices**: Billing invoices and financial records
- **Notification**: User notifications with read/unread status tracking
- **Organization**: Manage organizations and their settings
- **Organization - Balance**: Credit balances and financial transactions for organizations
- **Project**: Manage translation projects and their settings
- **Project - Reports**: Project-level usage and activity reports
- **Translatable Items**: Manage source content items for translation
- **Translations**: Manage translations for translatable items
- **Translations - Machine**: Machine translation services using various engines
- **User**: User profile and account management
- **Utilities**: Reference data including countries, locales, and supported languages
- **Deprecated**: Legacy endpoints retained for backward compatibility