Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/skills/{skill_id}/versions Retrieves all historical versions for the specified skill.

Path parameters

ParameterTypeRequiredDescription
skill_idstringYesSkill unique identifier

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT

Example request

curl -X GET https://openapi.qoder.sh/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 SkillVersion 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 has been deleted

Notes

  • Version numbers are returned as strings (such as "1").
  • The version list is ordered by creation time.
  • Each upload through POST /v1/skills increments the version number.
  • Updating metadata via PUT does not produce a new version.
See Errors for the full error envelope.