Get Skill Version - Open Managed Agents

GET

/

v1

/

skills

/

{skill_id}

/

versions

/

{version}

Get Skill Version

curl --request GET \
  --url http://localhost:38080/v1/skills/{skill_id}/versions/{version} \
  --header 'X-Api-Key: <api-key>' \
  --header 'anthropic-beta: <anthropic-beta>'

import requests

url = "http://localhost:38080/v1/skills/{skill_id}/versions/{version}"

headers = {
    "anthropic-beta": "<anthropic-beta>",
    "X-Api-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'anthropic-beta': '<anthropic-beta>', 'X-Api-Key': '<api-key>'}
};

fetch('http://localhost:38080/v1/skills/{skill_id}/versions/{version}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "http://localhost:38080/v1/skills/{skill_id}/versions/{version}"

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

	req.Header.Add("anthropic-beta", "<anthropic-beta>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "A custom skill for doing something useful",
  "directory": "my-skill",
  "id": "skillver_01JAbcdefghijklmnopqrstuvw",
  "name": "my-skill",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_version",
  "version": "1759178010641129"
}

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  },
  "request_id": "<string>",
  "type": "error"
}

Every request requires ?beta=true and anthropic-beta: skills-2025-10-02.

Authorizations

X-Api-Key

string

header

default:sk-ant-local-default

required

OMA workspace API key.

Headers

anthropic-beta

string

required

Optional header to specify the beta version(s) you want to use.

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

anthropic-version

string

The version of the OMA API you want to use.

Read more about versioning and our version history here.

Path Parameters

skill_id

string

required

Unique identifier for the skill.

The format and length of IDs may change over time.

version

string

required

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Query Parameters

beta

enum<boolean>

required

Selects the beta API contract for this endpoint. Must be true.

Available options:

true

Response

Successful Response

created_at

string

required

ISO 8601 timestamp of when the skill version was created.

Example:

"2024-10-30T23:58:27.427722Z"

description

string

required

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

Example:

"A custom skill for doing something useful"

directory

string

required

Directory name of the skill version.

This is the top-level directory name that was extracted from the uploaded files.

Example:

"my-skill"

id

string

required

Unique identifier for the skill version.

The format and length of IDs may change over time.

Example:

"skillver_01JAbcdefghijklmnopqrstuvw"

name

string

required

Human-readable name of the skill version.

This is extracted from the SKILL.md file in the skill upload.

Example:

"my-skill"

skill_id

string

required

Identifier for the skill that this version belongs to.

Example:

"skill_01JAbcdefghijklmnopqrstuvw"

type

string

default:skill_version

required

Object type.

For Skill Versions, this is always "skill_version".

version

string

required

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Example:

"1759178010641129"

Get Skill Version

curl --request GET \
  --url http://localhost:38080/v1/skills/{skill_id}/versions/{version} \
  --header 'X-Api-Key: <api-key>' \
  --header 'anthropic-beta: <anthropic-beta>'

import requests

url = "http://localhost:38080/v1/skills/{skill_id}/versions/{version}"

headers = {
    "anthropic-beta": "<anthropic-beta>",
    "X-Api-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'anthropic-beta': '<anthropic-beta>', 'X-Api-Key': '<api-key>'}
};

fetch('http://localhost:38080/v1/skills/{skill_id}/versions/{version}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "http://localhost:38080/v1/skills/{skill_id}/versions/{version}"

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

	req.Header.Add("anthropic-beta", "<anthropic-beta>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "A custom skill for doing something useful",
  "directory": "my-skill",
  "id": "skillver_01JAbcdefghijklmnopqrstuvw",
  "name": "my-skill",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "skill_version",
  "version": "1759178010641129"
}

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error"
  },
  "request_id": "<string>",
  "type": "error"
}