archastro.platform.v1.resources.private_services

  1# Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
  2# This file is auto-generated by @archastro/sdk-generator. Do not edit.
  3# Content hash: d9f86ab03baa
  4
  5from __future__ import annotations
  6
  7from typing import Any, Required, TypedDict
  8
  9from ...runtime.http_client import HttpClient, SyncHttpClient
 10from ...types.common import PrivateService, PrivateServicePage
 11
 12
 13class PrivateServiceCreateInputFunctionsItem(TypedDict, total=False):
 14    description: Required[str]
 15    "Human-readable guidance describing when and why to call the operation."
 16    input_schema: Required[dict[str, Any]]
 17    "JSON Schema Draft 7 object describing the operation's argument object."
 18    name: Required[str]
 19    "Stable operation name used when invoking the private service."
 20    output_schema: dict[str, Any] | None
 21    "Optional JSON Schema Draft 7 object describing the successful result."
 22
 23
 24class PrivateServiceCreateInput(TypedDict, total=False):
 25    "Create a private service"
 26
 27    functions: Required[list[PrivateServiceCreateInputFunctionsItem]]
 28    "Complete callable contracts. Input schemas are required; output schemas are optional."
 29    org: str | None
 30    "Organization ID or slug. Required for developer and server callers."
 31
 32
 33class AsyncPrivateServiceResource:
 34    def __init__(self, http: HttpClient):
 35        self._http = http
 36
 37    async def list(
 38        self, *, org: str | None = None, page: int | None = None, page_size: int | None = None
 39    ) -> PrivateServicePage:
 40        """
 41        List private services
 42
 43        Args:
 44            org: Organization ID or slug. Required for developer and server callers.
 45            page: Page number. Defaults to 1.
 46            page_size: Results per page. Defaults to 25; maximum is 100.
 47
 48        Returns:
 49            Successful response
 50        """
 51        query: dict[str, object] = {}
 52        if org is not None:
 53            query["org"] = org
 54        if page is not None:
 55            query["page"] = page
 56        if page_size is not None:
 57            query["page_size"] = page_size
 58        return await self._http.request(
 59            "/api/v1/private_services",
 60            query=query,
 61            response_type=PrivateServicePage,
 62        )
 63
 64    async def create(self, input: PrivateServiceCreateInput) -> PrivateService:
 65        """
 66        Create a private service
 67        Creates one immutable private service in the selected organization.
 68
 69        Args:
 70            input: Request body.
 71            input.functions: Complete callable contracts. Input schemas are required; output schemas are optional.
 72            input.org: Organization ID or slug. Required for developer and server callers.
 73
 74        Returns:
 75            The newly created private service.
 76        """
 77        return await self._http.request(
 78            "/api/v1/private_services",
 79            method="POST",
 80            body=input,
 81            response_type=PrivateService,
 82        )
 83
 84    async def get(self, private_service_id: str, *, org: str | None = None) -> PrivateService:
 85        """
 86        Retrieve a private service
 87
 88        Args:
 89            org: Organization ID or slug. Required for developer and server callers.
 90
 91        Returns:
 92            Successful response
 93        """
 94        query: dict[str, object] = {}
 95        if org is not None:
 96            query["org"] = org
 97        return await self._http.request(
 98            f"/api/v1/private_services/{private_service_id}",
 99            query=query,
100            response_type=PrivateService,
101        )
102
103
104class PrivateServiceResource:
105    def __init__(self, http: SyncHttpClient):
106        self._http = http
107
108    def list(
109        self, *, org: str | None = None, page: int | None = None, page_size: int | None = None
110    ) -> PrivateServicePage:
111        """
112        List private services
113
114        Args:
115            org: Organization ID or slug. Required for developer and server callers.
116            page: Page number. Defaults to 1.
117            page_size: Results per page. Defaults to 25; maximum is 100.
118
119        Returns:
120            Successful response
121        """
122        query: dict[str, object] = {}
123        if org is not None:
124            query["org"] = org
125        if page is not None:
126            query["page"] = page
127        if page_size is not None:
128            query["page_size"] = page_size
129        return self._http.request(
130            "/api/v1/private_services",
131            query=query,
132            response_type=PrivateServicePage,
133        )
134
135    def create(self, input: PrivateServiceCreateInput) -> PrivateService:
136        """
137        Create a private service
138        Creates one immutable private service in the selected organization.
139
140        Args:
141            input: Request body.
142            input.functions: Complete callable contracts. Input schemas are required; output schemas are optional.
143            input.org: Organization ID or slug. Required for developer and server callers.
144
145        Returns:
146            The newly created private service.
147        """
148        return self._http.request(
149            "/api/v1/private_services",
150            method="POST",
151            body=input,
152            response_type=PrivateService,
153        )
154
155    def get(self, private_service_id: str, *, org: str | None = None) -> PrivateService:
156        """
157        Retrieve a private service
158
159        Args:
160            org: Organization ID or slug. Required for developer and server callers.
161
162        Returns:
163            Successful response
164        """
165        query: dict[str, object] = {}
166        if org is not None:
167            query["org"] = org
168        return self._http.request(
169            f"/api/v1/private_services/{private_service_id}",
170            query=query,
171            response_type=PrivateService,
172        )