Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Elementum Skills API

Manage agent skills

Elementum Skills API is one of 18 APIs that Elementum publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Skills. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 2 paths, and defines 11 schemas. It is described by OpenAPI 3.0.1, at version 0.0.1.

Requests are made against a single base URL, /v1.

3 operations 2 paths 11 schemas 1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0.0.1
Base URL
https://api.elementum.io/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Elementum Skills API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (ClientCredentials) using the clientCredentials flow.

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 1 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Skills 3

Manage agent skills

GET
/apps/{alias}/skills
List skills under an app
listSkills 6 params → 200400401403404422429500
POST
/apps/{alias}/skills
Create a skill under an app
createSkill 1 param body → 201400401403404422429500
PUT
/apps/{alias}/skills/{id}
Update a skill by ID
updateSkill 2 params body → 200400401403404422429500

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are Aspect (13 properties), Skill (9 properties), SkillCreateInput (7 properties), SkillUpdateInput (7 properties). Each schema is shown below with its type and property counts.

PagingState
object
4 properties
SkillPagedList
object
3 properties
SkillUpdateInput
object
Skill fields to change. Omitted fields keep their current value.
7 properties
AspectCategoryRef
object
2 properties
SkillBundleUpdateRequest
object
Body for PUT /v1/apps/{alias}/skills/{id}.
2 properties 1 required
SkillDiscoveryProperties
object
Optional metadata that tunes how the skill is discovered and routed to.
5 properties
Aspect
object
13 properties
Skill
object
A skill returned by the skills endpoints.
9 properties
AspectSourceType
string
Where an aspect's data lives. ELEMENTUM = native; SNOWFLAKE = imported from a connected Snowflake table.
SkillBundleCreateRequest
object
Body for POST /v1/apps/{alias}/skills.
2 properties 1 required
SkillCreateInput
object
The skill to create. Owner (ownerType/ownerId) is derived from the URL alias.
7 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

elementum-skills-api-openapi.yml Raw ↑

Other APIs Elementum publishes across the network.

Elementum Access Token API
Elementum Agents API
Elementum Apps API
Elementum Attachments API
Elementum Automations API
Elementum Comments API
Elementum Domains API
Elementum Elements API
Elementum Flows API
Elementum Groups API
Elementum Records API
Elementum Related-items API