archastro.platform.v1.resources.solution_instances

 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: ce96189e7d0a
 4
 5from __future__ import annotations
 6
 7from ...runtime.http_client import HttpClient, SyncHttpClient
 8from ...types.common import SolutionInstanceListResponse
 9
10
11class AsyncSolutionInstanceResource:
12    def __init__(self, http: HttpClient):
13        self._http = http
14
15    async def list(
16        self,
17        solution_template_config_id: str,
18        *,
19        limit: int | None = None,
20        after_cursor: str | None = None,
21    ) -> SolutionInstanceListResponse:
22        """
23        List customer solution instances
24        Returns a forward cursor-paginated page of customer instances stamped from one
25        solution template. Results are restricted to the caller's organization; an
26        app-wide viewer without an organization scope is forbidden.
27        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
28        page. Each row includes the materialized agent, pinned template version, and
29        local-edit count computed by the solution-instance read path.
30
31        Args:
32            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
33            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
34            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
35
36        Returns:
37            Cursor-paginated customer solution instances visible to the caller.
38        """
39        query: dict[str, object] = {}
40        query["solution_template_config_id"] = solution_template_config_id
41        if limit is not None:
42            query["limit"] = limit
43        if after_cursor is not None:
44            query["after_cursor"] = after_cursor
45        return await self._http.request(
46            "/api/v1/solution_instances",
47            query=query,
48            response_type=SolutionInstanceListResponse,
49        )
50
51
52class SolutionInstanceResource:
53    def __init__(self, http: SyncHttpClient):
54        self._http = http
55
56    def list(
57        self,
58        solution_template_config_id: str,
59        *,
60        limit: int | None = None,
61        after_cursor: str | None = None,
62    ) -> SolutionInstanceListResponse:
63        """
64        List customer solution instances
65        Returns a forward cursor-paginated page of customer instances stamped from one
66        solution template. Results are restricted to the caller's organization; an
67        app-wide viewer without an organization scope is forbidden.
68        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
69        page. Each row includes the materialized agent, pinned template version, and
70        local-edit count computed by the solution-instance read path.
71
72        Args:
73            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
74            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
75            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
76
77        Returns:
78            Cursor-paginated customer solution instances visible to the caller.
79        """
80        query: dict[str, object] = {}
81        query["solution_template_config_id"] = solution_template_config_id
82        if limit is not None:
83            query["limit"] = limit
84        if after_cursor is not None:
85            query["after_cursor"] = after_cursor
86        return self._http.request(
87            "/api/v1/solution_instances",
88            query=query,
89            response_type=SolutionInstanceListResponse,
90        )
class AsyncSolutionInstanceResource:
12class AsyncSolutionInstanceResource:
13    def __init__(self, http: HttpClient):
14        self._http = http
15
16    async def list(
17        self,
18        solution_template_config_id: str,
19        *,
20        limit: int | None = None,
21        after_cursor: str | None = None,
22    ) -> SolutionInstanceListResponse:
23        """
24        List customer solution instances
25        Returns a forward cursor-paginated page of customer instances stamped from one
26        solution template. Results are restricted to the caller's organization; an
27        app-wide viewer without an organization scope is forbidden.
28        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
29        page. Each row includes the materialized agent, pinned template version, and
30        local-edit count computed by the solution-instance read path.
31
32        Args:
33            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
34            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
35            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
36
37        Returns:
38            Cursor-paginated customer solution instances visible to the caller.
39        """
40        query: dict[str, object] = {}
41        query["solution_template_config_id"] = solution_template_config_id
42        if limit is not None:
43            query["limit"] = limit
44        if after_cursor is not None:
45            query["after_cursor"] = after_cursor
46        return await self._http.request(
47            "/api/v1/solution_instances",
48            query=query,
49            response_type=SolutionInstanceListResponse,
50        )
AsyncSolutionInstanceResource(http: archastro.platform.runtime.http_client.HttpClient)
13    def __init__(self, http: HttpClient):
14        self._http = http
async def list( self, solution_template_config_id: str, *, limit: int | None = None, after_cursor: str | None = None) -> archastro.platform.types.common.SolutionInstanceListResponse:
16    async def list(
17        self,
18        solution_template_config_id: str,
19        *,
20        limit: int | None = None,
21        after_cursor: str | None = None,
22    ) -> SolutionInstanceListResponse:
23        """
24        List customer solution instances
25        Returns a forward cursor-paginated page of customer instances stamped from one
26        solution template. Results are restricted to the caller's organization; an
27        app-wide viewer without an organization scope is forbidden.
28        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
29        page. Each row includes the materialized agent, pinned template version, and
30        local-edit count computed by the solution-instance read path.
31
32        Args:
33            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
34            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
35            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
36
37        Returns:
38            Cursor-paginated customer solution instances visible to the caller.
39        """
40        query: dict[str, object] = {}
41        query["solution_template_config_id"] = solution_template_config_id
42        if limit is not None:
43            query["limit"] = limit
44        if after_cursor is not None:
45            query["after_cursor"] = after_cursor
46        return await self._http.request(
47            "/api/v1/solution_instances",
48            query=query,
49            response_type=SolutionInstanceListResponse,
50        )

List customer solution instances Returns a forward cursor-paginated page of customer instances stamped from one solution template. Results are restricted to the caller's organization; an app-wide viewer without an organization scope is forbidden. Pass after_cursor from a response with has_more: true to retrieve the next page. Each row includes the materialized agent, pinned template version, and local-edit count computed by the solution-instance read path.

Arguments:
  • solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
  • limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
  • after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
Returns:

Cursor-paginated customer solution instances visible to the caller.

class SolutionInstanceResource:
53class SolutionInstanceResource:
54    def __init__(self, http: SyncHttpClient):
55        self._http = http
56
57    def list(
58        self,
59        solution_template_config_id: str,
60        *,
61        limit: int | None = None,
62        after_cursor: str | None = None,
63    ) -> SolutionInstanceListResponse:
64        """
65        List customer solution instances
66        Returns a forward cursor-paginated page of customer instances stamped from one
67        solution template. Results are restricted to the caller's organization; an
68        app-wide viewer without an organization scope is forbidden.
69        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
70        page. Each row includes the materialized agent, pinned template version, and
71        local-edit count computed by the solution-instance read path.
72
73        Args:
74            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
75            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
76            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
77
78        Returns:
79            Cursor-paginated customer solution instances visible to the caller.
80        """
81        query: dict[str, object] = {}
82        query["solution_template_config_id"] = solution_template_config_id
83        if limit is not None:
84            query["limit"] = limit
85        if after_cursor is not None:
86            query["after_cursor"] = after_cursor
87        return self._http.request(
88            "/api/v1/solution_instances",
89            query=query,
90            response_type=SolutionInstanceListResponse,
91        )
SolutionInstanceResource(http: archastro.platform.runtime.http_client.SyncHttpClient)
54    def __init__(self, http: SyncHttpClient):
55        self._http = http
def list( self, solution_template_config_id: str, *, limit: int | None = None, after_cursor: str | None = None) -> archastro.platform.types.common.SolutionInstanceListResponse:
57    def list(
58        self,
59        solution_template_config_id: str,
60        *,
61        limit: int | None = None,
62        after_cursor: str | None = None,
63    ) -> SolutionInstanceListResponse:
64        """
65        List customer solution instances
66        Returns a forward cursor-paginated page of customer instances stamped from one
67        solution template. Results are restricted to the caller's organization; an
68        app-wide viewer without an organization scope is forbidden.
69        Pass `after_cursor` from a response with `has_more: true` to retrieve the next
70        page. Each row includes the materialized agent, pinned template version, and
71        local-edit count computed by the solution-instance read path.
72
73        Args:
74            solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
75            limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
76            after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
77
78        Returns:
79            Cursor-paginated customer solution instances visible to the caller.
80        """
81        query: dict[str, object] = {}
82        query["solution_template_config_id"] = solution_template_config_id
83        if limit is not None:
84            query["limit"] = limit
85        if after_cursor is not None:
86            query["after_cursor"] = after_cursor
87        return self._http.request(
88            "/api/v1/solution_instances",
89            query=query,
90            response_type=SolutionInstanceListResponse,
91        )

List customer solution instances Returns a forward cursor-paginated page of customer instances stamped from one solution template. Results are restricted to the caller's organization; an app-wide viewer without an organization scope is forbidden. Pass after_cursor from a response with has_more: true to retrieve the next page. Each row includes the materialized agent, pinned template version, and local-edit count computed by the solution-instance read path.

Arguments:
  • solution_template_config_id: ID of the installed solution template whose customer instances should be listed.
  • limit: Maximum number of instances to return. Defaults to 50; maximum is 100.
  • after_cursor: Opaque cursor returned by the preceding page. Omit to retrieve the first page.
Returns:

Cursor-paginated customer solution instances visible to the caller.