Skip to main content
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.
Authorization: Bearer <YOUR_API_KEY>
Missing or invalid tokens return 401 Unauthorized.

Endpoints

Assets
  • List assets — Get all assets you can read (Folders, Models, Sources, Orchestrations)
  • Get asset — Get a single asset by ID
  • Execute asset — Queue a run for a source, model, or orchestration
Model versions Jobs

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.
GET /api/public/v1/assets?limit=50&offset=100
Responses include a meta object with the values used plus a hasMore flag:
{
  "data": [ ... ],
  "meta": { "limit": 50, "offset": 100, "hasMore": true }
}
Continue paging by incrementing offset by limit until hasMore is false.