archastro.platform.v1.resources.agent_requests 

  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: 9643ae844548
  4
  5from __future__ import annotations
  6
  7from typing import Any, TypedDict
  8
  9from ...runtime.http_client import HttpClient, SyncHttpClient
 10from ...types.common import AgentRequest, AgentRequestListResponse
 11
 12
 13class AgentRequestRejectInput(TypedDict):
 14    "Reject an agent request"
 15
 16    reason: str
 17    "Reason for rejecting the request."
 18
 19
 20class AgentRequestResolveInput(TypedDict):
 21    "Resolve an agent request"
 22
 23    input: dict[str, Any]
 24    "Kind-specific input. Secrets must use secret_value."
 25
 26
 27class AsyncAgentRequestResource:
 28    def __init__(self, http: HttpClient):
 29        self._http = http
 30
 31    async def list(
 32        self,
 33        *,
 34        agent: str | None = None,
 35        status: str | None = None,
 36        kind: str | None = None,
 37        limit: int | None = None,
 38        cursor: str | None = None,
 39    ) -> AgentRequestListResponse:
 40        """
 41        List agent requests
 42        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
 43
 44        Args:
 45            agent: Filter by agent ID.
 46            status: open, resolved, rejected, expired or cancelled.
 47            kind: Filter by registered kind.
 48            limit: Page size, 1 100; default 25.
 49            cursor: Opaque next_cursor from a prior page.
 50
 51        Returns:
 52            A page of visible requests.
 53        """
 54        query: dict[str, object] = {}
 55        if agent is not None:
 56            query["agent"] = agent
 57        if status is not None:
 58            query["status"] = status
 59        if kind is not None:
 60            query["kind"] = kind
 61        if limit is not None:
 62            query["limit"] = limit
 63        if cursor is not None:
 64            query["cursor"] = cursor
 65        return await self._http.request(
 66            "/api/v1/agent_requests",
 67            query=query,
 68            response_type=AgentRequestListResponse,
 69        )
 70
 71    async def get(self, agent_request: str) -> AgentRequest:
 72        """
 73        Show an agent request
 74        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
 75
 76        Args:
 77            agent_request: Request ID (`arq_...`).
 78
 79        Returns:
 80            The request, without secret input.
 81        """
 82        return await self._http.request(
 83            f"/api/v1/agent_requests/{agent_request}",
 84            response_type=AgentRequest,
 85        )
 86
 87    async def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
 88        """
 89        Reject an agent request
 90        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
 91
 92        Args:
 93            agent_request: Request ID (`arq_...`).
 94            input: Request body.
 95            input.reason: Reason for rejecting the request.
 96
 97        Returns:
 98            The request, without secret input.
 99        """
100        return await self._http.request(
101            f"/api/v1/agent_requests/{agent_request}/reject",
102            method="POST",
103            body=input,
104            response_type=AgentRequest,
105        )
106
107    async def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
108        """
109        Resolve an agent request
110        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
111
112        Args:
113            agent_request: Request ID (`arq_...`).
114            input: Request body.
115            input.input: Kind-specific input. Secrets must use secret_value.
116
117        Returns:
118            The request, without secret input.
119        """
120        return await self._http.request(
121            f"/api/v1/agent_requests/{agent_request}/resolve",
122            method="POST",
123            body=input,
124            response_type=AgentRequest,
125        )
126
127
128class AgentRequestResource:
129    def __init__(self, http: SyncHttpClient):
130        self._http = http
131
132    def list(
133        self,
134        *,
135        agent: str | None = None,
136        status: str | None = None,
137        kind: str | None = None,
138        limit: int | None = None,
139        cursor: str | None = None,
140    ) -> AgentRequestListResponse:
141        """
142        List agent requests
143        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
144
145        Args:
146            agent: Filter by agent ID.
147            status: open, resolved, rejected, expired or cancelled.
148            kind: Filter by registered kind.
149            limit: Page size, 1 100; default 25.
150            cursor: Opaque next_cursor from a prior page.
151
152        Returns:
153            A page of visible requests.
154        """
155        query: dict[str, object] = {}
156        if agent is not None:
157            query["agent"] = agent
158        if status is not None:
159            query["status"] = status
160        if kind is not None:
161            query["kind"] = kind
162        if limit is not None:
163            query["limit"] = limit
164        if cursor is not None:
165            query["cursor"] = cursor
166        return self._http.request(
167            "/api/v1/agent_requests",
168            query=query,
169            response_type=AgentRequestListResponse,
170        )
171
172    def get(self, agent_request: str) -> AgentRequest:
173        """
174        Show an agent request
175        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
176
177        Args:
178            agent_request: Request ID (`arq_...`).
179
180        Returns:
181            The request, without secret input.
182        """
183        return self._http.request(
184            f"/api/v1/agent_requests/{agent_request}",
185            response_type=AgentRequest,
186        )
187
188    def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
189        """
190        Reject an agent request
191        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
192
193        Args:
194            agent_request: Request ID (`arq_...`).
195            input: Request body.
196            input.reason: Reason for rejecting the request.
197
198        Returns:
199            The request, without secret input.
200        """
201        return self._http.request(
202            f"/api/v1/agent_requests/{agent_request}/reject",
203            method="POST",
204            body=input,
205            response_type=AgentRequest,
206        )
207
208    def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
209        """
210        Resolve an agent request
211        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
212
213        Args:
214            agent_request: Request ID (`arq_...`).
215            input: Request body.
216            input.input: Kind-specific input. Secrets must use secret_value.
217
218        Returns:
219            The request, without secret input.
220        """
221        return self._http.request(
222            f"/api/v1/agent_requests/{agent_request}/resolve",
223            method="POST",
224            body=input,
225            response_type=AgentRequest,
226        )
class AgentRequestRejectInput(typing.TypedDict): 
14class AgentRequestRejectInput(TypedDict):
15    "Reject an agent request"
16
17    reason: str
18    "Reason for rejecting the request."

Reject an agent request

reason: str

Reason for rejecting the request.

class AgentRequestResolveInput(typing.TypedDict): 
21class AgentRequestResolveInput(TypedDict):
22    "Resolve an agent request"
23
24    input: dict[str, Any]
25    "Kind-specific input. Secrets must use secret_value."

Resolve an agent request

input: dict[str, typing.Any]

Kind-specific input. Secrets must use secret_value.

class AsyncAgentRequestResource: 
 28class AsyncAgentRequestResource:
 29    def __init__(self, http: HttpClient):
 30        self._http = http
 31
 32    async def list(
 33        self,
 34        *,
 35        agent: str | None = None,
 36        status: str | None = None,
 37        kind: str | None = None,
 38        limit: int | None = None,
 39        cursor: str | None = None,
 40    ) -> AgentRequestListResponse:
 41        """
 42        List agent requests
 43        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
 44
 45        Args:
 46            agent: Filter by agent ID.
 47            status: open, resolved, rejected, expired or cancelled.
 48            kind: Filter by registered kind.
 49            limit: Page size, 1 100; default 25.
 50            cursor: Opaque next_cursor from a prior page.
 51
 52        Returns:
 53            A page of visible requests.
 54        """
 55        query: dict[str, object] = {}
 56        if agent is not None:
 57            query["agent"] = agent
 58        if status is not None:
 59            query["status"] = status
 60        if kind is not None:
 61            query["kind"] = kind
 62        if limit is not None:
 63            query["limit"] = limit
 64        if cursor is not None:
 65            query["cursor"] = cursor
 66        return await self._http.request(
 67            "/api/v1/agent_requests",
 68            query=query,
 69            response_type=AgentRequestListResponse,
 70        )
 71
 72    async def get(self, agent_request: str) -> AgentRequest:
 73        """
 74        Show an agent request
 75        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
 76
 77        Args:
 78            agent_request: Request ID (`arq_...`).
 79
 80        Returns:
 81            The request, without secret input.
 82        """
 83        return await self._http.request(
 84            f"/api/v1/agent_requests/{agent_request}",
 85            response_type=AgentRequest,
 86        )
 87
 88    async def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
 89        """
 90        Reject an agent request
 91        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
 92
 93        Args:
 94            agent_request: Request ID (`arq_...`).
 95            input: Request body.
 96            input.reason: Reason for rejecting the request.
 97
 98        Returns:
 99            The request, without secret input.
100        """
101        return await self._http.request(
102            f"/api/v1/agent_requests/{agent_request}/reject",
103            method="POST",
104            body=input,
105            response_type=AgentRequest,
106        )
107
108    async def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
109        """
110        Resolve an agent request
111        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
112
113        Args:
114            agent_request: Request ID (`arq_...`).
115            input: Request body.
116            input.input: Kind-specific input. Secrets must use secret_value.
117
118        Returns:
119            The request, without secret input.
120        """
121        return await self._http.request(
122            f"/api/v1/agent_requests/{agent_request}/resolve",
123            method="POST",
124            body=input,
125            response_type=AgentRequest,
126        )
AsyncAgentRequestResource(http: archastro.platform.runtime.http_client.HttpClient) 
29    def __init__(self, http: HttpClient):
30        self._http = http
async def list( self, *, agent: str | None = None, status: str | None = None, kind: str | None = None, limit: int | None = None, cursor: str | None = None) -> archastro.platform.types.common.AgentRequestListResponse: 
32    async def list(
33        self,
34        *,
35        agent: str | None = None,
36        status: str | None = None,
37        kind: str | None = None,
38        limit: int | None = None,
39        cursor: str | None = None,
40    ) -> AgentRequestListResponse:
41        """
42        List agent requests
43        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
44
45        Args:
46            agent: Filter by agent ID.
47            status: open, resolved, rejected, expired or cancelled.
48            kind: Filter by registered kind.
49            limit: Page size, 1 100; default 25.
50            cursor: Opaque next_cursor from a prior page.
51
52        Returns:
53            A page of visible requests.
54        """
55        query: dict[str, object] = {}
56        if agent is not None:
57            query["agent"] = agent
58        if status is not None:
59            query["status"] = status
60        if kind is not None:
61            query["kind"] = kind
62        if limit is not None:
63            query["limit"] = limit
64        if cursor is not None:
65            query["cursor"] = cursor
66        return await self._http.request(
67            "/api/v1/agent_requests",
68            query=query,
69            response_type=AgentRequestListResponse,
70        )

List agent requests Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.

Arguments:
  • agent: Filter by agent ID.
  • status: open, resolved, rejected, expired or cancelled.
  • kind: Filter by registered kind.
  • limit: Page size, 1 100; default 25.
  • cursor: Opaque next_cursor from a prior page.
Returns:

A page of visible requests.

async def get(self, agent_request: str) -> archastro.platform.types.common.AgentRequest: 
72    async def get(self, agent_request: str) -> AgentRequest:
73        """
74        Show an agent request
75        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
76
77        Args:
78            agent_request: Request ID (`arq_...`).
79
80        Returns:
81            The request, without secret input.
82        """
83        return await self._http.request(
84            f"/api/v1/agent_requests/{agent_request}",
85            response_type=AgentRequest,
86        )

Show an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
Returns:

The request, without secret input.

async def reject( self, agent_request: str, input: AgentRequestRejectInput) -> archastro.platform.types.common.AgentRequest: 
 88    async def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
 89        """
 90        Reject an agent request
 91        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
 92
 93        Args:
 94            agent_request: Request ID (`arq_...`).
 95            input: Request body.
 96            input.reason: Reason for rejecting the request.
 97
 98        Returns:
 99            The request, without secret input.
100        """
101        return await self._http.request(
102            f"/api/v1/agent_requests/{agent_request}/reject",
103            method="POST",
104            body=input,
105            response_type=AgentRequest,
106        )

Reject an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
  • input: Request body.
  • input.reason: Reason for rejecting the request.
Returns:

The request, without secret input.

async def resolve( self, agent_request: str, input: AgentRequestResolveInput) -> archastro.platform.types.common.AgentRequest: 
108    async def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
109        """
110        Resolve an agent request
111        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
112
113        Args:
114            agent_request: Request ID (`arq_...`).
115            input: Request body.
116            input.input: Kind-specific input. Secrets must use secret_value.
117
118        Returns:
119            The request, without secret input.
120        """
121        return await self._http.request(
122            f"/api/v1/agent_requests/{agent_request}/resolve",
123            method="POST",
124            body=input,
125            response_type=AgentRequest,
126        )

Resolve an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
  • input: Request body.
  • input.input: Kind-specific input. Secrets must use secret_value.
Returns:

The request, without secret input.

class AgentRequestResource: 
129class AgentRequestResource:
130    def __init__(self, http: SyncHttpClient):
131        self._http = http
132
133    def list(
134        self,
135        *,
136        agent: str | None = None,
137        status: str | None = None,
138        kind: str | None = None,
139        limit: int | None = None,
140        cursor: str | None = None,
141    ) -> AgentRequestListResponse:
142        """
143        List agent requests
144        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
145
146        Args:
147            agent: Filter by agent ID.
148            status: open, resolved, rejected, expired or cancelled.
149            kind: Filter by registered kind.
150            limit: Page size, 1 100; default 25.
151            cursor: Opaque next_cursor from a prior page.
152
153        Returns:
154            A page of visible requests.
155        """
156        query: dict[str, object] = {}
157        if agent is not None:
158            query["agent"] = agent
159        if status is not None:
160            query["status"] = status
161        if kind is not None:
162            query["kind"] = kind
163        if limit is not None:
164            query["limit"] = limit
165        if cursor is not None:
166            query["cursor"] = cursor
167        return self._http.request(
168            "/api/v1/agent_requests",
169            query=query,
170            response_type=AgentRequestListResponse,
171        )
172
173    def get(self, agent_request: str) -> AgentRequest:
174        """
175        Show an agent request
176        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
177
178        Args:
179            agent_request: Request ID (`arq_...`).
180
181        Returns:
182            The request, without secret input.
183        """
184        return self._http.request(
185            f"/api/v1/agent_requests/{agent_request}",
186            response_type=AgentRequest,
187        )
188
189    def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
190        """
191        Reject an agent request
192        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
193
194        Args:
195            agent_request: Request ID (`arq_...`).
196            input: Request body.
197            input.reason: Reason for rejecting the request.
198
199        Returns:
200            The request, without secret input.
201        """
202        return self._http.request(
203            f"/api/v1/agent_requests/{agent_request}/reject",
204            method="POST",
205            body=input,
206            response_type=AgentRequest,
207        )
208
209    def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
210        """
211        Resolve an agent request
212        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
213
214        Args:
215            agent_request: Request ID (`arq_...`).
216            input: Request body.
217            input.input: Kind-specific input. Secrets must use secret_value.
218
219        Returns:
220            The request, without secret input.
221        """
222        return self._http.request(
223            f"/api/v1/agent_requests/{agent_request}/resolve",
224            method="POST",
225            body=input,
226            response_type=AgentRequest,
227        )
AgentRequestResource(http: archastro.platform.runtime.http_client.SyncHttpClient) 
130    def __init__(self, http: SyncHttpClient):
131        self._http = http
def list( self, *, agent: str | None = None, status: str | None = None, kind: str | None = None, limit: int | None = None, cursor: str | None = None) -> archastro.platform.types.common.AgentRequestListResponse: 
133    def list(
134        self,
135        *,
136        agent: str | None = None,
137        status: str | None = None,
138        kind: str | None = None,
139        limit: int | None = None,
140        cursor: str | None = None,
141    ) -> AgentRequestListResponse:
142        """
143        List agent requests
144        Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.
145
146        Args:
147            agent: Filter by agent ID.
148            status: open, resolved, rejected, expired or cancelled.
149            kind: Filter by registered kind.
150            limit: Page size, 1 100; default 25.
151            cursor: Opaque next_cursor from a prior page.
152
153        Returns:
154            A page of visible requests.
155        """
156        query: dict[str, object] = {}
157        if agent is not None:
158            query["agent"] = agent
159        if status is not None:
160            query["status"] = status
161        if kind is not None:
162            query["kind"] = kind
163        if limit is not None:
164            query["limit"] = limit
165        if cursor is not None:
166            query["cursor"] = cursor
167        return self._http.request(
168            "/api/v1/agent_requests",
169            query=query,
170            response_type=AgentRequestListResponse,
171        )

List agent requests Lists requests visible under the context policy, newest first. Filters are combined. Pagination is not a snapshot; later pages continue after the last returned request.

Arguments:
  • agent: Filter by agent ID.
  • status: open, resolved, rejected, expired or cancelled.
  • kind: Filter by registered kind.
  • limit: Page size, 1 100; default 25.
  • cursor: Opaque next_cursor from a prior page.
Returns:

A page of visible requests.

def get(self, agent_request: str) -> archastro.platform.types.common.AgentRequest: 
173    def get(self, agent_request: str) -> AgentRequest:
174        """
175        Show an agent request
176        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
177
178        Args:
179            agent_request: Request ID (`arq_...`).
180
181        Returns:
182            The request, without secret input.
183        """
184        return self._http.request(
185            f"/api/v1/agent_requests/{agent_request}",
186            response_type=AgentRequest,
187        )

Show an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
Returns:

The request, without secret input.

def reject( self, agent_request: str, input: AgentRequestRejectInput) -> archastro.platform.types.common.AgentRequest: 
189    def reject(self, agent_request: str, input: AgentRequestRejectInput) -> AgentRequest:
190        """
191        Reject an agent request
192        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
193
194        Args:
195            agent_request: Request ID (`arq_...`).
196            input: Request body.
197            input.reason: Reason for rejecting the request.
198
199        Returns:
200            The request, without secret input.
201        """
202        return self._http.request(
203            f"/api/v1/agent_requests/{agent_request}/reject",
204            method="POST",
205            body=input,
206            response_type=AgentRequest,
207        )

Reject an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
  • input: Request body.
  • input.reason: Reason for rejecting the request.
Returns:

The request, without secret input.

def resolve( self, agent_request: str, input: AgentRequestResolveInput) -> archastro.platform.types.common.AgentRequest: 
209    def resolve(self, agent_request: str, input: AgentRequestResolveInput) -> AgentRequest:
210        """
211        Resolve an agent request
212        Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.
213
214        Args:
215            agent_request: Request ID (`arq_...`).
216            input: Request body.
217            input.input: Kind-specific input. Secrets must use secret_value.
218
219        Returns:
220            The request, without secret input.
221        """
222        return self._http.request(
223            f"/api/v1/agent_requests/{agent_request}/resolve",
224            method="POST",
225            body=input,
226            response_type=AgentRequest,
227        )

Resolve an agent request Uses the request context visibility and approver policy. Agents cannot resolve or reject requests.

Arguments:
  • agent_request: Request ID (arq_...).
  • input: Request body.
  • input.input: Kind-specific input. Secrets must use secret_value.
Returns:

The request, without secret input.