{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adobe-captivate/refs/heads/main/json-schema/prime-api-skill-list-response-schema.json",
  "title": "SkillListResponse",
  "description": "Paginated list of skills",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "A skill competency defined in the Learning Manager system",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique skill identifier"
          },
          "type": {
            "type": "string",
            "const": "skill"
          },
          "attributes": {
            "type": "object",
            "properties": {
              "description": {
                "type": "string",
                "description": "Skill description"
              },
              "name": {
                "type": "string",
                "description": "Skill name"
              },
              "state": {
                "type": "string",
                "description": "Skill state",
                "enum": [
                  "Active",
                  "Retired"
                ]
              }
            }
          },
          "relationships": {
            "type": "object",
            "properties": {
              "skillLevels": {
                "type": "object",
                "description": "A JSON:API relationship object",
                "properties": {
                  "data": {
                    "oneOf": [
                      {
                        "type": "object",
                        "description": "JSON:API resource identifier",
                        "required": [
                          "id",
                          "type"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Resource identifier"
                          },
                          "type": {
                            "type": "string",
                            "description": "Resource type name"
                          }
                        }
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "description": "JSON:API resource identifier",
                          "required": [
                            "id",
                            "type"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "Resource identifier"
                            },
                            "type": {
                              "type": "string",
                              "description": "Resource type name"
                            }
                          }
                        }
                      }
                    ]
                  },
                  "links": {
                    "type": "object",
                    "properties": {
                      "related": {
                        "type": "string",
                        "format": "uri",
                        "description": "URL to fetch the related resource"
                      }
                    }
                  }
                }
              },
              "learningObjects": {
                "type": "object",
                "description": "A JSON:API relationship object",
                "properties": {
                  "data": {
                    "oneOf": [
                      {
                        "type": "object",
                        "description": "JSON:API resource identifier",
                        "required": [
                          "id",
                          "type"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Resource identifier"
                          },
                          "type": {
                            "type": "string",
                            "description": "Resource type name"
                          }
                        }
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "description": "JSON:API resource identifier",
                          "required": [
                            "id",
                            "type"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "Resource identifier"
                            },
                            "type": {
                              "type": "string",
                              "description": "Resource type name"
                            }
                          }
                        }
                      }
                    ]
                  },
                  "links": {
                    "type": "object",
                    "properties": {
                      "related": {
                        "type": "string",
                        "format": "uri",
                        "description": "URL to fetch the related resource"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "links": {
      "type": "object",
      "description": "Pagination links following JSON:API conventions",
      "properties": {
        "self": {
          "type": "string",
          "format": "uri",
          "description": "URL for the current page"
        },
        "next": {
          "type": "string",
          "format": "uri",
          "description": "URL for the next page"
        },
        "prev": {
          "type": "string",
          "format": "uri",
          "description": "URL for the previous page"
        }
      }
    }
  }
}