{"files":{"SKILL.md":"---\nname: cycat-org-api\ndescription: \"CyCAT.org API skill. Use when working with CyCAT.org for child, generate, info. Covers 14 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# CyCAT.org API\nAPI version: 0.9\n\n## Auth\nNo authentication required.\n\n## Base URL\nNot specified.\n\n## Setup\n1. No auth setup needed\n2. GET /generate/uuid -- verify access\n3. POST /propose -- create first propose\n\n## Endpoints\n\n14 endpoints across 10 groups. See references/api-spec.lap for full details.\n\n### child\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /child/{uuid} | Get child UUID(s) from a specified project or publisher UUID. |\n\n### generate\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /generate/uuid | Generate an UUID version 4 RFC4122-compliant. |\n\n### info\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /info | Get information about the CyCAT backend services including status, overall statistics and version. |\n\n### list\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /list/project/{start}/{end} | List projects registered in CyCAT by pagination (start,end). |\n| GET | /list/publisher/{start}/{end} | List publishers registered in CyCAT by pagination (start,end). |\n\n### lookup\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /lookup/{uuid} | Lookup UUID registered in CyCAT. |\n\n### namespace\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /namespace/finduuid/{namespace}/{namespaceid} | Get all known UUID for a given namespace id. |\n| GET | /namespace/getall | List all known namespaces. |\n| GET | /namespace/getid/{namespace} | Get all ID from a given namespace. |\n\n### parent\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /parent/{uuid} | Get parent UUID(s) from a specified project or item UUID. |\n\n### propose\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /propose | Propose new resource to CyCAT. |\n\n### relationships\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /relationships/expanded/{uuid} | Get relationship(s) UUID from a specified UUID including the relationships meta information. |\n| GET | /relationships/{uuid} | Get relationship(s) UUID from a specified UUID. |\n\n### search\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /search/{searchquery} | Full-text search in CyCAT and return matching UUID. |\n\n## Common Questions\n\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get child details?\" -> GET /child/{uuid}\n- \"List all uuid?\" -> GET /generate/uuid\n- \"List all info?\" -> GET /info\n- \"Get project details?\" -> GET /list/project/{start}/{end}\n- \"Get publisher details?\" -> GET /list/publisher/{start}/{end}\n- \"Get lookup details?\" -> GET /lookup/{uuid}\n- \"Get finduuid details?\" -> GET /namespace/finduuid/{namespace}/{namespaceid}\n- \"List all getall?\" -> GET /namespace/getall\n- \"Get getid details?\" -> GET /namespace/getid/{namespace}\n- \"Get parent details?\" -> GET /parent/{uuid}\n- \"Create a propose?\" -> POST /propose\n- \"Get expanded details?\" -> GET /relationships/expanded/{uuid}\n- \"Get relationship details?\" -> GET /relationships/{uuid}\n- \"Get search details?\" -> GET /search/{searchquery}\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints typically return the created/updated object\n\n## CLI\n\n```bash\n# Update this spec to the latest version\nnpx @lap-platform/lapsh get cycat-org-api -o references/api-spec.lap\n\n# Search for related APIs\nnpx @lap-platform/lapsh search cycat-org-api\n```\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api CyCAT.org API\n@version 0.9\n@endpoints 14\n@toc child(1), generate(1), info(1), list(2), lookup(1), namespace(3), parent(1), propose(1), relationships(2), search(1)\n\n@group child\n@endpoint GET /child/{uuid}\n@desc Get child UUID(s) from a specified project or publisher UUID.\n@returns(200) Success\n\n@endgroup\n\n@group generate\n@endpoint GET /generate/uuid\n@desc Generate an UUID version 4 RFC4122-compliant.\n@returns(200) Success\n\n@endgroup\n\n@group info\n@endpoint GET /info\n@desc Get information about the CyCAT backend services including status, overall statistics and version.\n@returns(200) Success\n\n@endgroup\n\n@group list\n@endpoint GET /list/project/{start}/{end}\n@desc List projects registered in CyCAT by pagination (start,end).\n@returns(200) Success\n\n@endpoint GET /list/publisher/{start}/{end}\n@desc List publishers registered in CyCAT by pagination (start,end).\n@returns(200) Success\n\n@endgroup\n\n@group lookup\n@endpoint GET /lookup/{uuid}\n@desc Lookup UUID registered in CyCAT.\n@returns(200) Success\n\n@endgroup\n\n@group namespace\n@endpoint GET /namespace/finduuid/{namespace}/{namespaceid}\n@desc Get all known UUID for a given namespace id.\n@returns(200) Success\n\n@endpoint GET /namespace/getall\n@desc List all known namespaces.\n@returns(200) Success\n\n@endpoint GET /namespace/getid/{namespace}\n@desc Get all ID from a given namespace.\n@returns(200) Success\n\n@endgroup\n\n@group parent\n@endpoint GET /parent/{uuid}\n@desc Get parent UUID(s) from a specified project or item UUID.\n@returns(200) Success\n\n@endgroup\n\n@group propose\n@endpoint POST /propose\n@desc Propose new resource to CyCAT.\n@returns(200) Success\n\n@endgroup\n\n@group relationships\n@endpoint GET /relationships/expanded/{uuid}\n@desc Get relationship(s) UUID from a specified UUID including the relationships meta information.\n@returns(200) Success\n\n@endpoint GET /relationships/{uuid}\n@desc Get relationship(s) UUID from a specified UUID.\n@returns(200) Success\n\n@endgroup\n\n@group search\n@endpoint GET /search/{searchquery}\n@desc Full-text search in CyCAT and return matching UUID.\n@returns(200) Success\n\n@endgroup\n\n@end\n"}}