Get a skill
Requires skills:read.
curl --request GET \
--url https://api.guild.ai/v1/skills/{skill_id_or_name} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.guild.ai/v1/skills/{skill_id_or_name}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.guild.ai/v1/skills/{skill_id_or_name}', 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://api.guild.ai/v1/skills/{skill_id_or_name}",
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: Basic <encoded-value>"
],
]);
$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://api.guild.ai/v1/skills/{skill_id_or_name}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.guild.ai/v1/skills/{skill_id_or_name}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.guild.ai/v1/skills/{skill_id_or_name}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "skill",
"full_name": "<string>",
"name": "<string>",
"overview": "<string>",
"is_public": true,
"avatar_url": "<string>",
"archived_at": "2023-11-07T05:31:56Z",
"owner": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "user",
"name": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"bio": "<string>",
"banner_url": "<string>",
"website_url": "<string>",
"github_url": "<string>",
"x_url": "<string>",
"linkedin_url": "<string>",
"discord_url": "<string>",
"youtube_url": "<string>",
"threads_url": "<string>",
"cached_likes_public_count": 123,
"cached_forks_public_count": 123,
"cached_installs_public_count": 123,
"email_domain": null
},
"likes_count": 123,
"viewer_can_edit": true,
"archived_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "user",
"name": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"bio": "<string>",
"banner_url": "<string>",
"website_url": "<string>",
"github_url": "<string>",
"x_url": "<string>",
"linkedin_url": "<string>",
"discord_url": "<string>",
"youtube_url": "<string>",
"threads_url": "<string>",
"cached_likes_public_count": 123,
"cached_forks_public_count": 123,
"cached_installs_public_count": 123,
"email_domain": null
},
"latest_version": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "skill_version",
"version_number": 123,
"description": "<string>"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
API key: key id as the username, secret as the password. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes.
Path Parameters
Response
Successful response
A skill as gen_serialize_skill emits it. full_name,
likes_count and viewer_can_edit are computed at serialization
time and exist on no entity.
skill 1008192255An account as gen_serialize_account emits it. Users and
organizations share the account pattern; email_domain appears only
for organizations.
Show child attributes
Show child attributes
An account as gen_serialize_account emits it. Users and
organizations share the account pattern; email_domain appears only
for organizations.
Show child attributes
Show child attributes
A skill version as gen_serialize_skill_version emits it (ITEM).
Show child attributes
Show child attributes
curl --request GET \
--url https://api.guild.ai/v1/skills/{skill_id_or_name} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.guild.ai/v1/skills/{skill_id_or_name}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.guild.ai/v1/skills/{skill_id_or_name}', 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://api.guild.ai/v1/skills/{skill_id_or_name}",
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: Basic <encoded-value>"
],
]);
$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://api.guild.ai/v1/skills/{skill_id_or_name}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.guild.ai/v1/skills/{skill_id_or_name}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.guild.ai/v1/skills/{skill_id_or_name}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "skill",
"full_name": "<string>",
"name": "<string>",
"overview": "<string>",
"is_public": true,
"avatar_url": "<string>",
"archived_at": "2023-11-07T05:31:56Z",
"owner": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "user",
"name": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"bio": "<string>",
"banner_url": "<string>",
"website_url": "<string>",
"github_url": "<string>",
"x_url": "<string>",
"linkedin_url": "<string>",
"discord_url": "<string>",
"youtube_url": "<string>",
"threads_url": "<string>",
"cached_likes_public_count": 123,
"cached_forks_public_count": 123,
"cached_installs_public_count": 123,
"email_domain": null
},
"likes_count": 123,
"viewer_can_edit": true,
"archived_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "user",
"name": "<string>",
"full_name": "<string>",
"avatar_url": "<string>",
"bio": "<string>",
"banner_url": "<string>",
"website_url": "<string>",
"github_url": "<string>",
"x_url": "<string>",
"linkedin_url": "<string>",
"discord_url": "<string>",
"youtube_url": "<string>",
"threads_url": "<string>",
"cached_likes_public_count": 123,
"cached_forks_public_count": 123,
"cached_installs_public_count": 123,
"email_domain": null
},
"latest_version": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"entity_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"type": "skill_version",
"version_number": 123,
"description": "<string>"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}