List workspace skills

curl --request GET \
  --url https://app.base44.com/api/workspace/skills \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/workspace/skills', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/workspace/skills",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/workspace/skills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/workspace/skills")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "created_by": "dana@acme.com",
      "created_date": "2026-08-01T09:15:00.123000Z",
      "description": "Use when writing any user-facing copy for our apps.",
      "enabled": true,
      "id": "68d2a1f4c9e7b3001f2a5c88",
      "name": "brand-voice",
      "updated_date": "2026-08-03T14:02:10.456000Z"
    }
  ],
  "total": 1
}

Skills

List workspace skills

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Returns every skill in a workspace, newest first, without their instructions. The list isn’t paginated. A workspace has at most 100 skills. Get a skill’s instructions with Get workspace skill.

Skills belong to the workspace your credential is for. With a personal access token, that’s the token’s workspace, and there’s no parameter to choose another one.

The AI builder sees the name and description of every enabled skill in the workspace, and loads a skill’s instructions when its description fits the task.

Skills need the Builder plan or higher. Below it, this returns a 403.

This is limited to 120 requests per minute, shared with Get workspace skill. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

Call this as any member of the workspace, with a personal access token sent as a Bearer token, or from a signed-in session. A read-only token is accepted, but workspace API keys aren’t.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

workspace

skills

List workspace skills

curl --request GET \
  --url https://app.base44.com/api/workspace/skills \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/workspace/skills', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/workspace/skills",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/workspace/skills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/workspace/skills")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "created_by": "dana@acme.com",
      "created_date": "2026-08-01T09:15:00.123000Z",
      "description": "Use when writing any user-facing copy for our apps.",
      "enabled": true,
      "id": "68d2a1f4c9e7b3001f2a5c88",
      "name": "brand-voice",
      "updated_date": "2026-08-03T14:02:10.456000Z"
    }
  ],
  "total": 1
}

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Response

The workspace's skills.

items

WorkspaceSkillSummary · object[]

required

Every skill in the workspace, newest first.

Show child attributes

Example:

[
  {
    "created_by": "dana@acme.com",
    "created_date": "2026-08-01T09:15:00.123000Z",
    "description": "Use when writing any user-facing copy for our apps.",
    "enabled": true,
    "id": "68d2a1f4c9e7b3001f2a5c88",
    "name": "brand-voice",
    "updated_date": "2026-08-03T14:02:10.456000Z"
  }
]

total

integer

required

Number of skills in items.

Example:

1

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

List workspace skills

Authorizations

Response