Skip to main content
GET
Python SDK

Authorizations

Authorization
string
header
required

Enter your API key (e.g. dai_sk_test_key_001)

Headers

Authorization
string
X-Workspace-Id
string | null

Path Parameters

skill_name
string
required

The skill's slug-style name (lowercase, hyphens/underscores).

Example:

"search-flights"

Cookies

decimal_session
string | null

Response

Successful Response

Full skill record returned by GET /api/v1/skills/{skill_name}.

id
string
required
name
string
required
stability
string
required
is_active
boolean
required
visibility
string
required
can_edit
boolean
required
can_share
boolean
required

Stricter than can_edit; required to publish or transfer

display_name
string | null
description
string | null
category
string | null
offer_scope
string
default:workspace

Who the trigger router offers this skill to: 'workspace' (every agent in the org) or 'restricted' (only agents it is explicitly assigned to via POST /agents/{name}/skills/{skill_id}). Set it on POST /skills or with PUT /skills/{id}.

trigger_phrases
string[] | null
embedding_model
string | null
embedding_dimensions
integer | null
latest_version
SkillVersionInfo · object | null
body_markdown
string | null
created_at
string | null
source_type
string | null
source_url
string | null
license
string | null
license_spdx
string | null
compatibility
string | null
allowed_tools
string[]
privacy_statement_url
string | null
data_handling_summary
string | null
safety_status
string | null
safety
Safety · object | null
safety_scan
Safety Scan · object | null
intent_review
Intent Review · object | null
content_status
string | null
content_review
Content Review · object | null
skill_safety
string | null
last_updated_at
string | null

last_synced_at for imported skills, else created_at

owner
SkillOwner · object | null
forked_from_skill_id
string | null
activation_count
integer
default:0

Your organization's view: activations its runs recorded in the last 30 days, counted as GET /skills counts them. A public skill another organization owns: all-time Times used (a compatibility alias of total_uses).

agents
SkillAgent · object[] | null

Your organization's agents whose runs loaded the skill in the last 30 days, with how many times each, most first. Absent for a public skill another organization owns.

agent_count
integer | null

How many agents agents lists. GET /skills counts them the same way.

Required range: x >= 0
total_users
integer | null

All-time distinct users in the public catalog view; unknown during legacy publication upgrades or absent for private owner diagnostics

Required range: x >= 0
total_uses
integer | null

All-time Times used in the public catalog view; absent for private owner diagnostics

Required range: x >= 0
usage_scope
Usage Scope · object | null

Allowlisted published lifetime usage and qualified quality window for the public catalog view

effectiveness_score
number | null
skill_score
number | null
score_components
Score Components · object | null
pass_rate
number | null
evaluated_count
integer | null

Graded runs behind pass_rate in the last 30 days. The dashboard shows no rate below 5.

success_rate
number | null
trend
string | null
trend_sample
integer | null

Graded runs in the smaller half of the 30-day window behind trend (first half against second). The dashboard shows no trend below 5.