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

# Introduction

> Use the Less API to fetch asset metadata, list model versions, and trigger runs.

The Less REST API enables you to programmatically interact with Less from third-party tools. All endpoints return JSON and live under `/api/public/v1`.

### Base URL

```
https://<your-workspace-host>/api/public/v1
```

The default workspace host is `app.less.tech`. If your workspace uses a different host, use that instead. The endpoint playground on each page lets you set the server before sending a request.

### Authentication

Authenticate requests with an API key passed as a bearer token. You can create an API key from **Profile → API Keys**.

```http theme={null}
Authorization: Bearer <YOUR_API_KEY>
```

Missing or invalid tokens return `401 Unauthorized`.

### Endpoints

**Assets**

* [List assets](/api-reference/endpoint/listAssets) — Get all assets you can read (Folders, Models, Sources, Orchestrations)
* [Get asset](/api-reference/endpoint/getAsset) — Get a single asset by ID
* [Execute asset](/api-reference/endpoint/executeAsset) — Queue a run for a source, model, or orchestration

**Model versions**

* [List model versions](/api-reference/endpoint/modelVersions) — Get all versions for a model
* [Get model version](/api-reference/endpoint/modelVersion) — Get a single version by ID
* [Get published version](/api-reference/endpoint/getModel) — Get the currently published version of a model

**Jobs**

* [Get job status](/api-reference/endpoint/getJob) — Get the status and timing for a job

### Pagination

List endpoints are paginated with `limit` and `offset` query parameters:

* `limit` — page size. Default `50`, maximum `100`.
* `offset` — number of items to skip from the start of the sorted list. Default `0`.

[List assets](/api-reference/endpoint/listAssets) also accepts an optional `folderId` query parameter (folder asset UUID) to scope results to a single folder.

```
GET /api/public/v1/assets?limit=50&offset=100
GET /api/public/v1/assets?folderId=<folder-uuid>&limit=50
```

Responses include a `meta` object with the values used plus a `hasMore` flag:

```json theme={null}
{
  "data": [ ... ],
  "meta": { "limit": 50, "offset": 100, "hasMore": true }
}
```

Continue paging by incrementing `offset` by `limit` until `hasMore` is `false`.