{"files":{"SKILL.md":"---\nname: shorten-rest-api-documentation\ndescription: \"Shorten.REST API Documentation API skill. Use when working with Shorten.REST API Documentation for aliases, clicks. Covers 6 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Shorten.REST API Documentation\nAPI version: 1.0.0\n\n## Auth\nApiKey x-api-key in header\n\n## Base URL\nhttps://api.shorten.rest\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /aliases -- verify access\n3. POST /aliases -- create first aliases\n\n## Endpoints\n\n6 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### aliases\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /aliases | Get alias |\n| POST | /aliases | Create alias |\n| PUT | /aliases | Update alias |\n| DELETE | /aliases | Delete alias |\n| GET | /aliases/all | Get aliases by domain |\n\n### clicks\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /clicks | Get clicks |\n\n## Common Questions\n\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all aliases?\" -> GET /aliases\n- \"Create a aliase?\" -> POST /aliases\n- \"List all all?\" -> GET /aliases/all\n- \"List all clicks?\" -> GET /clicks\n- \"How to authenticate?\" -> See Auth section\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- List endpoints may support pagination; check for limit, offset, or cursor params\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 shorten-rest-api-documentation -o references/api-spec.lap\n\n# Search for related APIs\nnpx @lap-platform/lapsh search shorten-rest-api-documentation\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 Shorten.REST API Documentation\n@base https://api.shorten.rest\n@version 1.0.0\n@auth ApiKey x-api-key in header\n@endpoints 6\n@toc aliases(5), clicks(1)\n\n@group aliases\n@endpoint GET /aliases\n@desc Get alias\n@required {aliasName: any # alias value (without `/` at the beginning)}\n@optional {domainName: any # domain which alias belongs to (string without `http/https` or `/`)}\n@returns(200) Alias model or **null**\n\n@endpoint POST /aliases\n@desc Create alias\n@required {alias: map # alias properties}\n@optional {domainName: any # domain which alias will belong to (string without `http/https` or `/`), aliasName: any # alias (without `/` at the beginning)}\n@returns(200) Response contains aliasName, domainName and full generated short link\n\n@endpoint PUT /aliases\n@desc Update alias\n@required {aliasName: any # alias (without `/` at the beginning), alias: map # alias properties you wish to be updated}\n@optional {domainName: any # domain which alias belongs to (string without `http/https` or `/`)}\n@returns(200) Empty response\n\n@endpoint DELETE /aliases\n@desc Delete alias\n@required {aliasName: any # alias (without `/` at the beginning)}\n@optional {domainName: any # domain which alias belongs to (string without `http/https` or `/`)}\n@returns(200) Empty response\n\n@endpoint GET /aliases/all\n@desc Get aliases by domain\n@optional {domainName: any # The domain name to get the aliases for (string without `http/https` or `/`), continueFrom: any # An ID returned by a previous query to continue aliases retrieval (see lastId in response), limit: any # Number of results to return per request}\n@returns(200) returns Array of aliases with lastId\n\n@endgroup\n\n@group clicks\n@endpoint GET /clicks\n@desc Get clicks\n@optional {continueFrom: any # An ID returned by a previous query to continue clicks retrieval (see lastId in response), limit: any # Number of results to return per request}\n@returns(200) returns Array of Click models, also returns lastId\n\n@endgroup\n\n@end\n"}}