---
title: "API Reference"
description: "REST API documentation for localskills.sh. Authentication methods, endpoint overview for skills, teams, SSO, SCIM, and CLI auth."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.localskills.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

The localskills.sh REST API powers all platform functionality. Full
interactive documentation is available at
[/api-docs](https://localskills.sh/api-docs).

## Authentication

All API endpoints accept two authentication methods:

**Session cookie**: included automatically when signed in via the browser.
Managed by Better Auth.

**Bearer token**: pass an API token in the `Authorization` header:

```text
Authorization: Bearer lsk_your_token_here
```

Bearer tokens are recommended for programmatic access, CI/CD pipelines, and
CLI usage. Personal tokens start with `lsk_`; organization tokens start with
`lskt_`.

## Endpoints overview

**Skills**: create, list, update, and delete skills. Manage versions
(publish, revert), download content and packages, and view analytics.

**Folders**: manage each organization's folder tree and per-folder access
restrictions.

**Organizations**: create and manage organizations, invite members, assign
roles, manage teams and custom roles, and upload avatars.

**Organization tokens & OIDC**: issue and revoke organization API tokens,
manage CI/CD trust policies, and exchange pipeline OIDC tokens for
short-lived access.

**SSO**: configure SAML 2.0 connections, retrieve SP metadata, and manage
identity provider settings and domain verification.

**SCIM**: SCIM 2.0 endpoints for automated user and group provisioning,
provider configuration, schemas, and resource types.

**User**: manage your profile, create and revoke API tokens, and view your
audit log.

**CLI Auth**: device code flow for CLI authentication. The CLI requests a
device code, the user approves in the browser, and the CLI polls for
completion.

For full endpoint details, request and response schemas, and interactive
testing, visit the
[interactive API documentation](https://localskills.sh/api-docs).

Source: https://docs.localskills.sh/api-reference/index.mdx