IonWarp logoIonWarp
Get started
IonWarp Docs
Collections

Skills

Skills this agent can run, and where their executed bytes come from.

Base path /api/v1/skills on https://ionwarp.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.

List skills

GET /api/v1/skills

curl "https://ionwarp.com/api/v1/skills?source=catalog" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
What skills can you run?
data_query {
  "collection": "skills",
  "where": {
    "source": "catalog"
  }
}

Returns a paginated list of skill objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "skill",
      "id": "your-id",
      "name": "name",
      "description": "description",
      "version": "version",
      "source": "catalog",
      "inputs": {},
      "outputs": {},
      "integrations": [],
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
sourcestringfilterWhich bytes execute: the build-embedded catalog, a project/workspace override, or a reviewer body served from a checked-out workspace. One of catalog, project_override, workspace_body.
qstringsearchFree-text search across name, description.
sortstringsortOne of id; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

Retrieve a skill

GET /api/v1/skills/learning-tests-run-under-bun

curl "https://ionwarp.com/api/v1/skills/learning-tests-run-under-bun" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
Open the skill {id}
data_get {
  "collection": "skills",
  "object_id": "learning-tests-run-under-bun"
}

Returns the skill object.

{
  "object": "skill",
  "id": "your-id",
  "name": "name",
  "description": "description",
  "version": "version",
  "source": "catalog",
  "inputs": {},
  "outputs": {},
  "integrations": [],
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe skill's id or slug.

What comes back (read-only)

Every skill carries the envelope below. This resource declares no server-owned fields beyond it.

FieldTypeDescription
objectstringAlways skill.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

IonWarp logoIonWarp

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans