GET /api/skills — List All Skills in Your Workspace

GET /api/skills returns every Skill that exists in your current Workspace. Use this endpoint to build dashboards, sync Skills to external tools, or discover skill_id values before calling POST /v1/skills/run. Results are returned newest-first and can be paginated with page and page_size query parameters.

Endpoint

GET https://api.valendata.com/api/skills

Authentication

This endpoint requires a session token, not an API key. Pass your JWT in the Authorization header:

Authorization: Bearer YOUR_SESSION_TOKEN

To get a session token, call POST /api/auth/login with your email and password. The response includes a token field, use that here.

Query Parameters

integer

default:"1"

One-based page number to return. Combine with page_size to page through large Skill libraries.

integer

default:"20"

Number of Skill objects per page. Accepts values between 1 and 100.

Example Request

cURL
cURL (paginated)
Python
Node.js

curl https://api.valendata.com/api/skills \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

curl "https://api.valendata.com/api/skills?page=2&page_size=10" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

import requests

response = requests.get(
    "https://api.valendata.com/api/skills",
    headers={"Authorization": "Bearer YOUR_SESSION_TOKEN"},
    params={"page": 1, "page_size": 20},
)

skills = response.json()["skills"]
for skill in skills:
    print(skill["id"], skill["name"])

const response = await fetch(
  "https://api.valendata.com/api/skills?page=1&page_size=20",
  {
    headers: { "Authorization": "Bearer YOUR_SESSION_TOKEN" },
  }
);

const { skills, total } = await response.json();
console.log(`Fetched ${skills.length} of ${total} skills`);

Response

A successful request returns HTTP 200 with a JSON envelope containing a paginated list of Skill objects.

Envelope Fields

array

Array of Skill objects for the current page. See Skill Object below for the shape of each element.

integer

The total number of Skills in your Workspace, regardless of pagination. Use this to calculate how many pages remain: Math.ceil(total / page_size).

integer

The page number that was applied to this response, reflecting the page parameter you sent (or the default of 1).

integer

The page size that was applied to this response, reflecting the page_size parameter you sent (or the default of 20).

Skill Object

string

Unique identifier for the Skill, formatted as skl_.... Pass this value as skill_id when calling POST /v1/skills/run.

string

The human-readable name of the Skill as set when it was created or last updated in the dashboard.

string

A short description of what the Skill does, drawn from the task prompt or manually entered by the author.

string

The currently published version of the Skill. Valendata versions Skills on every publish so older integrations continue working even after you update the automation logic.

string

ISO 8601 UTC timestamp indicating when the Skill was first created.

Example Response

{
  "skills": [
    {
      "id": "skl_b281b8165a23",
      "name": "Google Maps SF Software Companies Scraper",
      "description": "Scrapes software companies in San Francisco from Google Maps, including name, website, address, rating, and reviews.",
      "version": "1.0.0",
      "created_at": "2026-08-01T14:22:11Z"
    },
    {
      "id": "skl_c394d9276b34",
      "name": "Competitor Pricing Monitor",
      "description": "Extracts product names, prices, and stock status from a target e-commerce URL.",
      "version": "1.2.3",
      "created_at": "2026-07-28T09:45:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "page_size": 20
}

Paginating Through All Skills

If your Workspace contains more Skills than a single page can hold, iterate over page until you have retrieved all records.

import requests

all_skills = []
page = 1
page_size = 100

while True:
    response = requests.get(
        "https://api.valendata.com/api/skills",
        headers={"Authorization": "Bearer YOUR_SESSION_TOKEN"},
        params={"page": page, "page_size": page_size},
    )
    payload = response.json()
    all_skills.extend(payload["skills"])

    if page * page_size >= payload["total"]:
        break
    page += 1

print(f"Retrieved {len(all_skills)} skills in total")

Error Handling

HTTP Status	Meaning
`401`	Unauthorized, session token is missing or expired.
`429`	Rate limited, slow down your request cadence.
`500`	Internal error, check status.valendata.com for ongoing incidents.

Overview

Skills

Workflows

Runs

GET /api/skills — List All Skills in Your Workspace

Endpoint

Authentication

Query Parameters

Example Request

Response

Envelope Fields

Skill Object

Example Response

Paginating Through All Skills

Error Handling

​Endpoint

​Authentication

​Query Parameters

​Example Request

​Response

​Envelope Fields

​Skill Object

​Example Response

​Paginating Through All Skills

​Error Handling

Endpoint

Authentication

Query Parameters

Example Request

Response

Envelope Fields

Skill Object

Example Response

Paginating Through All Skills

Error Handling