Skip to main content
GET /v1/skills/{skill_id}/versions Returns the current stored version descriptor for the specified skill as a data array.

​
Path parameters

ParameterTypeRequiredDescription
skill_idstringYesSkill unique identifier

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

​
Example request

curl -X GET https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "data": [
    {
      "version": "1",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "status": "active",
      "content_size": 309,
      "content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
      "created_at": "2026-05-18T15:35:24.248164Z",
      "updated_at": "2026-05-18T15:36:01.767469Z"
    }
  ]
}

​
Response fields

FieldTypeDescription
dataarrayArray of Skill version objects

​
SkillVersion object

FieldTypeDescription
versionstringVersion number (string format, e.g. "1", "2")
skill_idstringOwning Skill ID
statusstringVersion status: active
content_sizeintegerSize of the version’s zip content in bytes
content_sha256stringSHA-256 hash of the version’s content
created_atstringVersion creation time (ISO 8601)
updated_atstringVersion last-update time (ISO 8601)

​
Errors

HTTPTypeTrigger
401TOKEN_INVALIDMissing or invalid authentication token
404not_found_errorSkill does not exist or is no longer accessible

​
Notes

  • Version numbers are returned as strings (such as "1").
  • The current implementation returns the active Skill’s current version descriptor.
  • Updating content through PUT /v1/skills/{skill_id} increments the version number.
  • Updating metadata only does not increment the version.
See Errors for the full error envelope.

Agent Skills

Attach domain expertise to your agent.