Skip to main content
POST
/
v1
/
skills
/
lookup
!pip install vlmrun

from vlmrun.client import VLMRun

client = VLMRun(api_key="<VLMRUN_API_KEY>")

# Lookup by skill name
skill = client.agent.skills.get(name="invoice-extraction")

# Lookup by skill name and version
skill = client.agent.skills.get(name="invoice-extraction", version="20260219-abc123")

# Lookup by skill ID
skill = client.agent.skills.get(id="<skill-id>")

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "skill_version": "latest",
  "skill_uri": "<string>",
  "is_public": false,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
!pip install vlmrun

from vlmrun.client import VLMRun

client = VLMRun(api_key="<VLMRUN_API_KEY>")

# Lookup by skill name
skill = client.agent.skills.get(name="invoice-extraction")

# Lookup by skill name and version
skill = client.agent.skills.get(name="invoice-extraction", version="20260219-abc123")

# Lookup by skill ID
skill = client.agent.skills.get(id="<skill-id>")

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request to lookup a skill.

​
name
string | null

The name of the skill (e.g. 'pillow', 'batch-processing')

​
id
string | null

The ID of the skill (UUID)

​
skill_version
string | null

Skill version to look up (e.g. '20260219-abc123'). When provided with name, filters by exact version instead of returning latest.

​
version
string | null

DEPRECATED: Use 'skill_version' instead.

Response

Successful Response

Skill information response.

​
id
string
required

Unique skill identifier

​
name
string
required

Name of the skill

​
description
string
required

Description of the skill

​
skill_version
string
default:latest

Version of the skill

​
skill_uri
string | null

GCS URI of the skill zip file

​
is_public
boolean
default:false

Whether the skill is publicly accessible

​
created_at
string<date-time> | null

Date and time when the skill was created

​
updated_at
string<date-time> | null

Date and time when the skill was updated