[{"data":1,"prerenderedAt":804},["ShallowReactive",2],{"navigation_docs":3,"-services-api-api-reference":134,"-services-api-api-reference-surround":799},[4,36,61,87,113],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":35},"Getting Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-sparkles",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-zap",{"title":21,"path":22,"stem":23,"icon":24},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F3.authentication","i-lucide-key",{"title":26,"path":27,"stem":28,"icon":29},"Rate Limits & Quotas","\u002Fgetting-started\u002Frate-limits-quotas","1.getting-started\u002F4.rate-limits-quotas","i-lucide-gauge",{"title":31,"path":32,"stem":33,"icon":34},"SDKs & Tools","\u002Fgetting-started\u002Fsdks-tools","1.getting-started\u002F5.sdks-tools","i-lucide-box",false,{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":35},"Cloud Infrastructure","i-lucide-server","\u002Finfrastructure","2.infrastructure",[42,46,51,56],{"title":43,"path":44,"stem":45,"icon":38},"Cloud VPS Compute","\u002Finfrastructure\u002Fvps-compute","2.infrastructure\u002F1.vps-compute",{"title":47,"path":48,"stem":49,"icon":50},"Managed Databases","\u002Finfrastructure\u002Fmanaged-databases","2.infrastructure\u002F2.managed-databases","i-lucide-database",{"title":52,"path":53,"stem":54,"icon":55},"Networking & Cloud Firewall","\u002Finfrastructure\u002Fnetworking-firewall","2.infrastructure\u002F3.networking-firewall","i-lucide-shield",{"title":57,"path":58,"stem":59,"icon":60},"Block Storage & Volumes","\u002Finfrastructure\u002Fblock-storage","2.infrastructure\u002F4.block-storage","i-lucide-hard-drive",{"title":62,"icon":63,"path":64,"stem":65,"children":66,"page":35},"Services & APIs","i-lucide-cpu","\u002Fservices-api","3.services-api",[67,72,77,82],{"title":68,"path":69,"stem":70,"icon":71},"REST API Reference","\u002Fservices-api\u002Fapi-reference","3.services-api\u002F1.api-reference","i-lucide-terminal",{"title":73,"path":74,"stem":75,"icon":76},"URL Shortener API","\u002Fservices-api\u002Furl-shortener","3.services-api\u002F2.url-shortener","i-lucide-link",{"title":78,"path":79,"stem":80,"icon":81},"Temp Mail API","\u002Fservices-api\u002Ftemp-mail","3.services-api\u002F3.temp-mail","i-lucide-mail",{"title":83,"path":84,"stem":85,"icon":86},"Developer Utility APIs","\u002Fservices-api\u002Fdeveloper-utilities","3.services-api\u002F4.developer-utilities","i-lucide-wrench",{"title":88,"icon":89,"path":90,"stem":91,"children":92,"page":35},"Guides & Tutorials","i-lucide-book-open","\u002Fguides","4.guides",[93,98,103,108],{"title":94,"path":95,"stem":96,"icon":97},"Deploy a Full-Stack App with VPS & PostgreSQL","\u002Fguides\u002Fdeploy-fullstack-app","4.guides\u002F1.deploy-fullstack-app","i-lucide-layers",{"title":99,"path":100,"stem":101,"icon":102},"Automated Backups & Webhook Alerts","\u002Fguides\u002Fautomated-backups-webhook","4.guides\u002F2.automated-backups-webhook","i-lucide-bell",{"title":104,"path":105,"stem":106,"icon":107},"E2E Auth Testing with Temp Mail in CI\u002FCD","\u002Fguides\u002Fci-cd-temp-mail-testing","4.guides\u002F3.ci-cd-temp-mail-testing","i-lucide-check-circle-2",{"title":109,"path":110,"stem":111,"icon":112},"Custom Domain & SSL Configuration","\u002Fguides\u002Fcustom-domain-setup","4.guides\u002F4.custom-domain-setup","i-lucide-globe",{"title":114,"icon":115,"path":116,"stem":117,"children":118,"page":35},"Account & Billing","i-lucide-credit-card","\u002Faccount-billing","5.account-billing",[119,124,129],{"title":120,"path":121,"stem":122,"icon":123},"Pricing & Hourly Billing","\u002Faccount-billing\u002Fpricing-billing","5.account-billing\u002F1.pricing-billing","i-lucide-receipt",{"title":125,"path":126,"stem":127,"icon":128},"Team Management & RBAC","\u002Faccount-billing\u002Fteam-rbac","5.account-billing\u002F2.team-rbac","i-lucide-users",{"title":130,"path":131,"stem":132,"icon":133},"Resource Quotas & Service Limits","\u002Faccount-billing\u002Fservice-limits","5.account-billing\u002F3.service-limits","i-lucide-sliders",{"id":135,"title":68,"body":136,"description":790,"extension":791,"links":792,"meta":793,"navigation":794,"path":69,"seo":795,"stem":70,"__hash__":798},"docs\u002F3.services-api\u002F1.api-reference.md",{"type":137,"value":138,"toc":782},"minimark",[139,144,153,156,161,207,209,213,220,354,356,360,371,382,496,498,502,513,639,644,778],[140,141,143],"h1",{"id":142},"rest-api-overview","REST API Overview",[145,146,147,148,152],"p",{},"The ",[149,150,151],"strong",{},"1st Services API"," is organized around RESTful principles. All request bodies and responses use standard JSON encoding.",[154,155],"hr",{},[157,158,160],"h2",{"id":159},"base-urls","Base URLs",[162,163,164,178],"table",{},[165,166,167],"thead",{},[168,169,170,175],"tr",{},[171,172,174],"th",{"align":173},"left","Environment",[171,176,177],{"align":173},"Base URL",[179,180,181,195],"tbody",{},[168,182,183,189],{},[184,185,186],"td",{"align":173},[149,187,188],{},"Production",[184,190,191],{"align":173},[192,193,194],"code",{},"https:\u002F\u002Fapi.1st-services.com\u002Fv1",[168,196,197,202],{},[184,198,199],{"align":173},[149,200,201],{},"Sandbox \u002F Mock",[184,203,204],{"align":173},[192,205,206],{},"https:\u002F\u002Fsandbox-api.1st-services.com\u002Fv1",[154,208],{},[157,210,212],{"id":211},"standard-response-envelope","Standard Response Envelope",[145,214,215,216,219],{},"Successful API requests return an HTTP ",[192,217,218],{},"2xx"," status code wrapped in a consistent response envelope:",[221,222,227],"pre",{"className":223,"code":224,"language":225,"meta":226,"style":226},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"status\": \"success\",\n  \"data\": { ... },\n  \"meta\": {\n    \"request_id\": \"req_839120489\",\n    \"timestamp\": 1771849200\n  }\n}\n","json","",[192,228,229,238,266,288,303,326,342,348],{"__ignoreMap":226},[230,231,234],"span",{"class":232,"line":233},"line",1,[230,235,237],{"class":236},"sMK4o","{\n",[230,239,241,244,248,251,254,257,261,263],{"class":232,"line":240},2,[230,242,243],{"class":236},"  \"",[230,245,247],{"class":246},"spNyl","status",[230,249,250],{"class":236},"\"",[230,252,253],{"class":236},":",[230,255,256],{"class":236}," \"",[230,258,260],{"class":259},"sfazB","success",[230,262,250],{"class":236},[230,264,265],{"class":236},",\n",[230,267,269,271,274,276,278,281,285],{"class":232,"line":268},3,[230,270,243],{"class":236},[230,272,273],{"class":246},"data",[230,275,250],{"class":236},[230,277,253],{"class":236},[230,279,280],{"class":236}," {",[230,282,284],{"class":283},"sTEyZ"," ... ",[230,286,287],{"class":236},"},\n",[230,289,291,293,296,298,300],{"class":232,"line":290},4,[230,292,243],{"class":236},[230,294,295],{"class":246},"meta",[230,297,250],{"class":236},[230,299,253],{"class":236},[230,301,302],{"class":236}," {\n",[230,304,306,309,313,315,317,319,322,324],{"class":232,"line":305},5,[230,307,308],{"class":236},"    \"",[230,310,312],{"class":311},"sBMFI","request_id",[230,314,250],{"class":236},[230,316,253],{"class":236},[230,318,256],{"class":236},[230,320,321],{"class":259},"req_839120489",[230,323,250],{"class":236},[230,325,265],{"class":236},[230,327,329,331,334,336,338],{"class":232,"line":328},6,[230,330,308],{"class":236},[230,332,333],{"class":311},"timestamp",[230,335,250],{"class":236},[230,337,253],{"class":236},[230,339,341],{"class":340},"sbssI"," 1771849200\n",[230,343,345],{"class":232,"line":344},7,[230,346,347],{"class":236},"  }\n",[230,349,351],{"class":232,"line":350},8,[230,352,353],{"class":236},"}\n",[154,355],{},[157,357,359],{"id":358},"pagination","Pagination",[145,361,362,363,366,367,370],{},"List endpoints support cursor-based pagination with ",[192,364,365],{},"limit"," and ",[192,368,369],{},"starting_after"," query parameters:",[221,372,376],{"className":373,"code":374,"language":375,"meta":226,"style":226},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","GET \u002Fv1\u002Fshortener\u002Flinks?limit=25&starting_after=link_884920 HTTP\u002F1.1\n","http",[192,377,378],{"__ignoreMap":226},[230,379,380],{"class":232,"line":233},[230,381,374],{},[221,383,385],{"className":223,"code":384,"language":225,"meta":226,"style":226},"{\n  \"status\": \"success\",\n  \"data\": [ ... ],\n  \"meta\": {\n    \"has_more\": true,\n    \"next_cursor\": \"link_992144\",\n    \"total_count\": 348\n  }\n}\n",[192,386,387,391,409,427,439,453,473,487,491],{"__ignoreMap":226},[230,388,389],{"class":232,"line":233},[230,390,237],{"class":236},[230,392,393,395,397,399,401,403,405,407],{"class":232,"line":240},[230,394,243],{"class":236},[230,396,247],{"class":246},[230,398,250],{"class":236},[230,400,253],{"class":236},[230,402,256],{"class":236},[230,404,260],{"class":259},[230,406,250],{"class":236},[230,408,265],{"class":236},[230,410,411,413,415,417,419,422,424],{"class":232,"line":268},[230,412,243],{"class":236},[230,414,273],{"class":246},[230,416,250],{"class":236},[230,418,253],{"class":236},[230,420,421],{"class":236}," [",[230,423,284],{"class":283},[230,425,426],{"class":236},"],\n",[230,428,429,431,433,435,437],{"class":232,"line":290},[230,430,243],{"class":236},[230,432,295],{"class":246},[230,434,250],{"class":236},[230,436,253],{"class":236},[230,438,302],{"class":236},[230,440,441,443,446,448,450],{"class":232,"line":305},[230,442,308],{"class":236},[230,444,445],{"class":311},"has_more",[230,447,250],{"class":236},[230,449,253],{"class":236},[230,451,452],{"class":236}," true,\n",[230,454,455,457,460,462,464,466,469,471],{"class":232,"line":328},[230,456,308],{"class":236},[230,458,459],{"class":311},"next_cursor",[230,461,250],{"class":236},[230,463,253],{"class":236},[230,465,256],{"class":236},[230,467,468],{"class":259},"link_992144",[230,470,250],{"class":236},[230,472,265],{"class":236},[230,474,475,477,480,482,484],{"class":232,"line":344},[230,476,308],{"class":236},[230,478,479],{"class":311},"total_count",[230,481,250],{"class":236},[230,483,253],{"class":236},[230,485,486],{"class":340}," 348\n",[230,488,489],{"class":232,"line":350},[230,490,347],{"class":236},[230,492,494],{"class":232,"line":493},9,[230,495,353],{"class":236},[154,497],{},[157,499,501],{"id":500},"error-handling-error-codes","Error Handling & Error Codes",[145,503,504,505,508,509,512],{},"When an error occurs, the API returns an appropriate HTTP status code (",[192,506,507],{},"4xx"," or ",[192,510,511],{},"5xx",") and a structured error object:",[221,514,516],{"className":223,"code":515,"language":225,"meta":226,"style":226},"{\n  \"status\": \"error\",\n  \"error\": {\n    \"code\": \"RESOURCE_NOT_FOUND\",\n    \"message\": \"The requested VPS instance ID 'vps_999' was not found.\",\n    \"field\": \"instance_id\",\n    \"doc_url\": \"https:\u002F\u002Fdocs.1st-services.com\u002Fservices-api\u002Fapi-reference#errors\"\n  }\n}\n",[192,517,518,522,541,553,572,592,612,631,635],{"__ignoreMap":226},[230,519,520],{"class":232,"line":233},[230,521,237],{"class":236},[230,523,524,526,528,530,532,534,537,539],{"class":232,"line":240},[230,525,243],{"class":236},[230,527,247],{"class":246},[230,529,250],{"class":236},[230,531,253],{"class":236},[230,533,256],{"class":236},[230,535,536],{"class":259},"error",[230,538,250],{"class":236},[230,540,265],{"class":236},[230,542,543,545,547,549,551],{"class":232,"line":268},[230,544,243],{"class":236},[230,546,536],{"class":246},[230,548,250],{"class":236},[230,550,253],{"class":236},[230,552,302],{"class":236},[230,554,555,557,559,561,563,565,568,570],{"class":232,"line":290},[230,556,308],{"class":236},[230,558,192],{"class":311},[230,560,250],{"class":236},[230,562,253],{"class":236},[230,564,256],{"class":236},[230,566,567],{"class":259},"RESOURCE_NOT_FOUND",[230,569,250],{"class":236},[230,571,265],{"class":236},[230,573,574,576,579,581,583,585,588,590],{"class":232,"line":305},[230,575,308],{"class":236},[230,577,578],{"class":311},"message",[230,580,250],{"class":236},[230,582,253],{"class":236},[230,584,256],{"class":236},[230,586,587],{"class":259},"The requested VPS instance ID 'vps_999' was not found.",[230,589,250],{"class":236},[230,591,265],{"class":236},[230,593,594,596,599,601,603,605,608,610],{"class":232,"line":328},[230,595,308],{"class":236},[230,597,598],{"class":311},"field",[230,600,250],{"class":236},[230,602,253],{"class":236},[230,604,256],{"class":236},[230,606,607],{"class":259},"instance_id",[230,609,250],{"class":236},[230,611,265],{"class":236},[230,613,614,616,619,621,623,625,628],{"class":232,"line":344},[230,615,308],{"class":236},[230,617,618],{"class":311},"doc_url",[230,620,250],{"class":236},[230,622,253],{"class":236},[230,624,256],{"class":236},[230,626,627],{"class":259},"https:\u002F\u002Fdocs.1st-services.com\u002Fservices-api\u002Fapi-reference#errors",[230,629,630],{"class":236},"\"\n",[230,632,633],{"class":232,"line":350},[230,634,347],{"class":236},[230,636,637],{"class":232,"line":493},[230,638,353],{"class":236},[640,641,643],"h3",{"id":642},"common-http-status-codes","Common HTTP Status Codes",[162,645,646,659],{},[165,647,648],{},[168,649,650,653,656],{},[171,651,652],{"align":173},"Code",[171,654,655],{"align":173},"Status",[171,657,658],{"align":173},"Meaning",[179,660,661,674,687,700,713,726,739,752,765],{},[168,662,663,668,671],{},[184,664,665],{"align":173},[192,666,667],{},"200",[184,669,670],{"align":173},"OK",[184,672,673],{"align":173},"Request succeeded.",[168,675,676,681,684],{},[184,677,678],{"align":173},[192,679,680],{},"201",[184,682,683],{"align":173},"Created",[184,685,686],{"align":173},"Resource provisioned successfully.",[168,688,689,694,697],{},[184,690,691],{"align":173},[192,692,693],{},"400",[184,695,696],{"align":173},"Bad Request",[184,698,699],{"align":173},"Malformed payload or validation error.",[168,701,702,707,710],{},[184,703,704],{"align":173},[192,705,706],{},"401",[184,708,709],{"align":173},"Unauthorized",[184,711,712],{"align":173},"Missing or invalid API key.",[168,714,715,720,723],{},[184,716,717],{"align":173},[192,718,719],{},"403",[184,721,722],{"align":173},"Forbidden",[184,724,725],{"align":173},"Key does not possess the required scopes.",[168,727,728,733,736],{},[184,729,730],{"align":173},[192,731,732],{},"404",[184,734,735],{"align":173},"Not Found",[184,737,738],{"align":173},"Target resource does not exist.",[168,740,741,746,749],{},[184,742,743],{"align":173},[192,744,745],{},"409",[184,747,748],{"align":173},"Conflict",[184,750,751],{"align":173},"Conflict (e.g. custom domain or slug already taken).",[168,753,754,759,762],{},[184,755,756],{"align":173},[192,757,758],{},"429",[184,760,761],{"align":173},"Too Many Requests",[184,763,764],{"align":173},"Rate limit exceeded.",[168,766,767,772,775],{},[184,768,769],{"align":173},[192,770,771],{},"500",[184,773,774],{"align":173},"Internal Server Error",[184,776,777],{"align":173},"Transient server error. Contact support.",[779,780,781],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":226,"searchDepth":240,"depth":240,"links":783},[784,785,786,787],{"id":159,"depth":240,"text":160},{"id":211,"depth":240,"text":212},{"id":358,"depth":240,"text":359},{"id":500,"depth":240,"text":501,"children":788},[789],{"id":642,"depth":268,"text":643},"General API conventions, base URLs, pagination standards, and error payloads for 1st Services.","md",null,{},{"icon":71},{"title":796,"description":797},"REST API Overview - 1st Services","Comprehensive overview of the 1st Services REST API architecture and data models.","doPoYSGyDwObpOPYEDMvG0QsxG2Q5bvdQltY0IhMBjE",[800,802],{"title":57,"path":58,"stem":59,"description":801,"icon":60,"children":-1},"High-performance NVMe block storage volumes scalable up to 32TB with live volume resizing.",{"title":73,"path":74,"stem":75,"description":803,"icon":76,"children":-1},"Enterprise URL shortening, custom branded domains, deep linking, click analytics, and QR code generation.",1787568615158]