{"files":{"SKILL.md":"---\nname: topleveldomains-api-client\ndescription: \"TopLevelDomains API Client API skill. Use when working with TopLevelDomains API Client for subscriptions. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# TopLevelDomains API Client\nAPI version: 2018-02-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains -- get all top-level domains supported for registration.\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements -- create first listAgreement\n\n## Endpoints\n3 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains | Get all top-level domains supported for registration. |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name} | Get details of a top-level domain. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements | Gets all legal agreements that user needs to accept before purchasing a domain. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all topLevelDomains?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains\n- \"Get topLevelDomain details?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}\n- \"Create a listAgreement?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\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 TopLevelDomains API Client\n@base https://management.azure.com\n@version 2018-02-01\n@auth OAuth2\n@endpoints 3\n@toc subscriptions(3)\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains\n@desc Get all top-level domains supported for registration.\n@required {subscriptionId: any # Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., api-version: any # API Version}\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}\n@desc Get details of a top-level domain.\n@required {name: any # Name of the top-level domain., subscriptionId: any # Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., api-version: any # API Version}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements\n@desc Gets all legal agreements that user needs to accept before purchasing a domain.\n@required {name: any # Name of the top-level domain., agreementOption: map # Domain agreement options., subscriptionId: any # Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., api-version: any # API Version}\n@returns(200) OK\n\n@end\n"}}