archastro.platform.v1.resources.slack_channel_bindings

  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: 739c91726193
  4
  5from __future__ import annotations
  6
  7import builtins
  8from typing import Any, Literal, Required, TypedDict
  9
 10from pydantic import BaseModel, Field
 11
 12from ...runtime.http_client import HttpClient, SyncHttpClient
 13from ...types.common import (
 14    SlackChannelBinding,
 15    SlackChannelBindingListResponse,
 16    SlackDeliveryOutcomeListResponse,
 17)
 18
 19
 20class SlackChannelBindingCreateInput(TypedDict, total=False):
 21    "Create or update a Slack channel binding"
 22
 23    agent_user_ids: Required[list[str]]
 24    "List of agent user IDs to attach to the binding and enroll as members of the destination team. Pass an empty array to bind the channel without attaching any agents."
 25    allow_bot_conversations: bool | None
 26    "Opt this channel into sustained bot-to-bot conversation: the reply loop brake is disabled for its mirror thread. Set when the counterparty is a known bot the agent should keep answering. Omitting the parameter leaves the stored value unchanged."
 27    channel_id: Required[str]
 28    "Slack channel ID to bind (e.g. `C01234ABCDE`). Acts as the natural key of the binding within the workspace."
 29    customer_label: str | None
 30    "Human-readable label for the customer associated with this channel. Stored in the binding's config. `null` if omitted."
 31    is_ext_shared_cached: bool | None
 32    "Cached value of Slack's `is_ext_shared` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. `null` if omitted."
 33    is_private_cached: bool | None
 34    "Cached value of Slack's `is_private` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. Private channels are member-managed. `null` if omitted."
 35    slack_team_id: Required[str]
 36    "Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use."
 37    team_id: Required[str]
 38    "ID of the team to bind the Slack channel to. The caller must have team-manage rights on this team."
 39
 40
 41class SlackChannelBindingProvisionInput(TypedDict, total=False):
 42    "Start adding a customer over Slack Connect"
 43
 44    channel_name: str | None
 45    "Name for a Slack channel to create for this customer. Required unless `existing_channel_id` is given. The channel is created private."
 46    customer_email: str | None
 47    "Address the Slack Connect invite is sent to. Required when creating a channel; optional when adopting one the customer is already in. Whoever accepts becomes the verified counterparty."
 48    customer_key: Required[str]
 49    "The vendor's own primary key for this customer (`customer_id` / `account_id` / `tenant_id`). The per-customer agent's data access is locked to it. Immutable once the customer is added: re-targeting means offboarding and re-provisioning."
 50    customer_label: Required[str]
 51    "Human-readable name for the customer (e.g. `Acme, Inc.`). Used for the vendor's own dashboards and as the per-customer Team's name. Not an identity or an access control input."
 52    existing_channel_id: str | None
 53    "Adopt this already-shared Slack Connect channel (e.g. `C01234ABCDE`) instead of creating one. Mutually exclusive with `channel_name`."
 54    inputs: dict[str, Any] | None
 55    "String-keyed values the per-customer solution instance is stamped with. Defaults to an empty map."
 56    slack_team_id: Required[str]
 57    "Slack workspace team ID of the vendor's own Slack installation (e.g. `T01234ABCDE`). The customer's workspace is not known yet it resolves from whoever accepts."
 58    template_config_id: Required[str]
 59    "Config ID (`cfg_ `) of the org-installed Solution the per-customer instance is stamped from. Must be the organization's own installed copy, not the catalog original instances stamped from a different config do not appear in the vendor's customer fleet."
 60
 61
 62class SlackChannelBindingDepositThreadInput(TypedDict, total=False):
 63    "Point a Slack channel's deposit pipe at a staging thread, or turn it off"
 64
 65    slack_team_id: Required[str]
 66    "Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use."
 67    thread_id: str | None
 68    "Staging thread ID (primary key, `thr_ `) deposits should flow into. Pass `null` to turn the pipe off."
 69
 70
 71class SlackChannelBindingDeleteResponse(BaseModel):
 72    """
 73    Successful response
 74    """
 75
 76    channel: str = Field(..., description="Slack channel ID of the binding that was deleted.")
 77    deleted: bool = Field(
 78        ..., description="Always `true` when the binding was successfully removed."
 79    )
 80
 81
 82class AsyncSlackChannelBindingResource:
 83    def __init__(self, http: HttpClient):
 84        self._http = http
 85
 86    async def list(
 87        self,
 88        *,
 89        integration: builtins.list[str] | None = None,
 90        team: builtins.list[str] | None = None,
 91        agent: builtins.list[str] | None = None,
 92        org: builtins.list[str] | None = None,
 93        page: int | None = None,
 94        per_page: int | None = None,
 95    ) -> SlackChannelBindingListResponse:
 96        """
 97        List Slack channel bindings
 98        Returns a page of Slack channel bindings visible to the authenticated user.
 99        Results can be filtered by integration, team, agent, or organization. Omit all
100        filter params to retrieve every binding the caller can see.
101        Pagination is page-based. Pass `page` and `per_page` to navigate large result
102        sets. `page` must be a positive integer; `per_page` must be between 1 and 100.
103        Invalid values return 400.
104
105        Args:
106            integration: Return only bindings whose Slack integration matches one of these integration IDs. Omit to return bindings across all integrations.
107            team: Return only bindings bound to one of these team IDs. Omit to return bindings for all teams.
108            agent: Return only bindings that have at least one of these agent user IDs attached. Omit to return bindings regardless of agent attachment.
109            org: Return only bindings that belong to one of these organization IDs. Omit to return bindings across all organizations visible to the caller.
110            page: Page number to retrieve, 1-indexed. Defaults to 1. Must be a positive integer.
111            per_page: Number of bindings to return per page. Defaults to 25; maximum is 100.
112
113        Returns:
114            Paginated list of Slack channel bindings visible to the caller.
115        """
116        query: dict[str, object] = {}
117        if integration is not None:
118            query["integration"] = integration
119        if team is not None:
120            query["team"] = team
121        if agent is not None:
122            query["agent"] = agent
123        if org is not None:
124            query["org"] = org
125        if page is not None:
126            query["page"] = page
127        if per_page is not None:
128            query["per_page"] = per_page
129        return await self._http.request(
130            "/api/v1/slack_channel_bindings",
131            query=query,
132            response_type=SlackChannelBindingListResponse,
133        )
134
135    async def create(self, input: SlackChannelBindingCreateInput) -> SlackChannelBinding:
136        """
137        Create or update a Slack channel binding
138        Creates a new binding between a Slack channel and a team, or updates the
139        existing binding if one already exists for the given channel. The caller also
140        supplies a list of agents to attach to the binding and enroll as members of the
141        destination team.
142        The caller must have team-manage rights on the destination team (and on the
143        currently bound team if the channel is being re-pointed). Returns 403 if
144        permission is insufficient. All write steps are idempotent, so retrying after
145        a partial failure is safe.
146        On success the REST endpoint returns 201 Created. The script binding
147        (`slack.channel_bindings.upsert`) returns the full binding object including the
148        attached agents.
149
150        Args:
151            input: Request body.
152            input.agent_user_ids: List of agent user IDs to attach to the binding and enroll as members of the destination team. Pass an empty array to bind the channel without attaching any agents.
153            input.allow_bot_conversations: Opt this channel into sustained bot-to-bot conversation: the reply loop brake is disabled for its mirror thread. Set when the counterparty is a known bot the agent should keep answering. Omitting the parameter leaves the stored value unchanged.
154            input.channel_id: Slack channel ID to bind (e.g. `C01234ABCDE`). Acts as the natural key of the binding within the workspace.
155            input.customer_label: Human-readable label for the customer associated with this channel. Stored in the binding's config. `null` if omitted.
156            input.is_ext_shared_cached: Cached value of Slack's `is_ext_shared` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. `null` if omitted.
157            input.is_private_cached: Cached value of Slack's `is_private` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. Private channels are member-managed. `null` if omitted.
158            input.slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use.
159            input.team_id: ID of the team to bind the Slack channel to. The caller must have team-manage rights on this team.
160
161        Returns:
162            The created or updated Slack channel binding, including the full list of currently attached agents.
163        """
164        return await self._http.request(
165            "/api/v1/slack_channel_bindings",
166            method="POST",
167            body=input,
168            response_type=SlackChannelBinding,
169        )
170
171    async def provision(self, input: SlackChannelBindingProvisionInput) -> SlackChannelBinding:
172        """
173        Start adding a customer over Slack Connect
174        Opens a Slack Connect channel with a new customer creating one and sending
175        the invite, or adopting a shared channel you already have and records who is
176        adding whom so the addition can finish once the customer accepts.
177        The returned binding is **pending**: nothing mirrors, and no per-customer Team,
178        agent, or solution instance exists yet. Acceptance is asynchronous and may
179        never come. When it does, the addition completes in the background under the
180        identity of the admin who called this endpoint, re-checked live at that moment.
181        A caller who has since lost their admin role does not get a substitute the
182        addition is refused and a human re-adds the customer.
183        The caller must be an admin of the Slack integration's own organization. This
184        is the same authority the completion demands, checked here so a customer is
185        never invited into a channel whose addition can never finish.
186        Deliberately not exposed as a script binding: this sends mail to a person
187        outside the org, so it stays a vendor-admin HTTP surface.
188
189        Args:
190            input: Request body.
191            input.channel_name: Name for a Slack channel to create for this customer. Required unless `existing_channel_id` is given. The channel is created private.
192            input.customer_email: Address the Slack Connect invite is sent to. Required when creating a channel; optional when adopting one the customer is already in. Whoever accepts becomes the verified counterparty.
193            input.customer_key: The vendor's own primary key for this customer (`customer_id` / `account_id` / `tenant_id`). The per-customer agent's data access is locked to it. Immutable once the customer is added: re-targeting means offboarding and re-provisioning.
194            input.customer_label: Human-readable name for the customer (e.g. `Acme, Inc.`). Used for the vendor's own dashboards and as the per-customer Team's name. Not an identity or an access control input.
195            input.existing_channel_id: Adopt this already-shared Slack Connect channel (e.g. `C01234ABCDE`) instead of creating one. Mutually exclusive with `channel_name`.
196            input.inputs: String-keyed values the per-customer solution instance is stamped with. Defaults to an empty map.
197            input.slack_team_id: Slack workspace team ID of the vendor's own Slack installation (e.g. `T01234ABCDE`). The customer's workspace is not known yet it resolves from whoever accepts.
198            input.template_config_id: Config ID (`cfg_ `) of the org-installed Solution the per-customer instance is stamped from. Must be the organization's own installed copy, not the catalog original instances stamped from a different config do not appear in the vendor's customer fleet.
199
200        Returns:
201            The pending binding for the customer's channel. `disclosure_state` is `pending` until the customer accepts, and `scope_key` is null until the addition finishes.
202        """
203        return await self._http.request(
204            "/api/v1/slack_channel_bindings/provision",
205            method="POST",
206            body=input,
207            response_type=SlackChannelBinding,
208        )
209
210    async def delete(self, channel: str) -> SlackChannelBindingDeleteResponse:
211        """
212        Delete a Slack channel binding
213        Removes the binding between a Slack channel and its associated team. The
214        channel is identified by its Slack channel ID together with the `slack_team_id`
215        that scopes it to a specific Slack workspace. Removing the binding does not
216        delete the bound team or any conversation threads scoped to it; decommission
217        those resources separately if required.
218        The caller must have team-manage rights on the team the channel is currently
219        bound to. Returning 403 indicates insufficient permission; returning 404
220        indicates the binding does not exist or is not visible to the caller.
221        The REST endpoint returns 204 No Content on success. The script binding
222        (`slack.channel_bindings.delete`) returns a confirmation object so script
223        callers can verify success without an additional fetch. Both paths are
224        idempotent retrying after a partial failure is safe.
225
226        Args:
227            channel: Slack channel ID of the binding to delete (e.g. `C01234ABCDE`).
228
229        Returns:
230            Successful response
231        """
232        return await self._http.request(
233            f"/api/v1/slack_channel_bindings/{channel}",
234            method="DELETE",
235            response_type=SlackChannelBindingDeleteResponse,
236        )
237
238    async def get(self, channel: str, slack_team_id: str) -> SlackChannelBinding:
239        """
240        Retrieve a Slack channel binding
241        Returns the Slack channel binding identified by a Slack channel ID and workspace
242        team ID pair. Use this endpoint to look up the team and agents currently bound
243        to a specific Slack channel.
244        The `channel` path parameter is the Slack channel ID; `slack_team_id` identifies
245        the Slack workspace the channel belongs to, disambiguating channels with the same
246        ID across workspaces. Both parameters are required. Returns 404 if no binding
247        exists for the given pair or the associated Slack integration is not visible to
248        the caller.
249
250        Args:
251            channel: Slack channel ID of the binding to retrieve (e.g. `C01234ABCDE`).
252            slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Used together with `channel` to uniquely identify the binding.
253
254        Returns:
255            The Slack channel binding for the given channel and workspace.
256        """
257        query: dict[str, object] = {}
258        query["slack_team_id"] = slack_team_id
259        return await self._http.request(
260            f"/api/v1/slack_channel_bindings/{channel}",
261            query=query,
262            response_type=SlackChannelBinding,
263        )
264
265    async def delivery_outcomes(
266        self,
267        channel: str,
268        *,
269        since: str | None = None,
270        outcome: Literal["delivered", "floored", "judge_refused", "failed"] | None = None,
271        limit: int | None = None,
272        before_cursor: str | None = None,
273        after_cursor: str | None = None,
274    ) -> SlackDeliveryOutcomeListResponse:
275        """
276        List delivery outcomes for a Slack channel
277        Returns what happened to each agent message this platform sent to a Slack
278        channel, newest attempt first.
279        A message that never appears in a Slack channel has several possible causes
280        that look identical from the channel itself: a content guard withheld it, the
281        cross-org judge refused it, Slack rejected the call, or nobody asked anything.
282        This endpoint tells them apart. Use it to confirm a reply was delivered, or to
283        find out why one never arrived, without reading the channel's mirrored
284        conversation.
285        Outcomes cover **outbound agent messages only**. They carry no message
286        content, no author, and nothing about inbound messages. Access follows the
287        channel's binding the organization and app the channel is bound to and
288        needs no membership in the mirrored thread.
289        Paginated with opaque cursors, newest first. When `has_more` is true, pass the
290        response's `before_cursor` back as `before_cursor` to continue into older
291        history. `since` and `outcome` narrow the result set; they are filters, not
292        paging controls.
293
294        Args:
295            channel: Slack channel ID to read delivery outcomes for (e.g. `C01234ABCDE`).
296            since: Only return attempts at or after this ISO 8601 timestamp (e.g. `2026-08-11T00:00:00Z`). Omit to return the most recent attempts regardless of age.
297            outcome: Return only attempts with this outcome. Omit to return every outcome. Use `floored` and `judge_refused` to see only what was withheld.
298            limit: Maximum number of outcomes to return. Defaults to 50; maximum is 200.
299            before_cursor: Opaque cursor from a previous response; returns outcomes older than it. Cursors are not parseable and are only valid against this endpoint.
300            after_cursor: Opaque cursor from a previous response; returns outcomes newer than it. Suited to a UI loading newer entries. To poll for everything recorded since a point in time, prefer `since` with a little overlap and de-duplicate on `id` `after_cursor` can miss an attempt recorded in the same millisecond as the cursor's own row.
301
302        Returns:
303            Delivery outcomes for the requested channel, newest first.
304        """
305        query: dict[str, object] = {}
306        if since is not None:
307            query["since"] = since
308        if outcome is not None:
309            query["outcome"] = outcome
310        if limit is not None:
311            query["limit"] = limit
312        if before_cursor is not None:
313            query["before_cursor"] = before_cursor
314        if after_cursor is not None:
315            query["after_cursor"] = after_cursor
316        return await self._http.request(
317            f"/api/v1/slack_channel_bindings/{channel}/delivery_outcomes",
318            query=query,
319            response_type=SlackDeliveryOutcomeListResponse,
320        )
321
322    async def deposit_thread(
323        self, channel: str, input: SlackChannelBindingDepositThreadInput
324    ) -> SlackChannelBinding:
325        """
326        Point a Slack channel's deposit pipe at a staging thread, or turn it off
327        Sets the binding's deposit target the internal staging thread the
328        deposit pipe copies this channel's mirror content into. Pass a `null`
329        `thread_id` to turn the pipe off.
330        The target is validated server-side: it must exist, belong to the
331        binding's app and org, and never be a Slack mirror thread. Customer
332        bindings (bound `team_id`) additionally require a team-owned private
333        thread with no participant list, so the staging read ACL stays governed
334        by the channel-membership projection. Re-pointing or clearing an
335        existing target purges the old thread's deposit entries.
336
337        Args:
338            channel: Slack channel ID whose binding is being configured (e.g. `C01234ABCDE`).
339            input: Request body.
340            input.slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use.
341            input.thread_id: Staging thread ID (primary key, `thr_ `) deposits should flow into. Pass `null` to turn the pipe off.
342
343        Returns:
344            The binding with the updated deposit config.
345        """
346        return await self._http.request(
347            f"/api/v1/slack_channel_bindings/{channel}/deposit_thread",
348            method="POST",
349            body=input,
350            response_type=SlackChannelBinding,
351        )
352
353
354class SlackChannelBindingResource:
355    def __init__(self, http: SyncHttpClient):
356        self._http = http
357
358    def list(
359        self,
360        *,
361        integration: builtins.list[str] | None = None,
362        team: builtins.list[str] | None = None,
363        agent: builtins.list[str] | None = None,
364        org: builtins.list[str] | None = None,
365        page: int | None = None,
366        per_page: int | None = None,
367    ) -> SlackChannelBindingListResponse:
368        """
369        List Slack channel bindings
370        Returns a page of Slack channel bindings visible to the authenticated user.
371        Results can be filtered by integration, team, agent, or organization. Omit all
372        filter params to retrieve every binding the caller can see.
373        Pagination is page-based. Pass `page` and `per_page` to navigate large result
374        sets. `page` must be a positive integer; `per_page` must be between 1 and 100.
375        Invalid values return 400.
376
377        Args:
378            integration: Return only bindings whose Slack integration matches one of these integration IDs. Omit to return bindings across all integrations.
379            team: Return only bindings bound to one of these team IDs. Omit to return bindings for all teams.
380            agent: Return only bindings that have at least one of these agent user IDs attached. Omit to return bindings regardless of agent attachment.
381            org: Return only bindings that belong to one of these organization IDs. Omit to return bindings across all organizations visible to the caller.
382            page: Page number to retrieve, 1-indexed. Defaults to 1. Must be a positive integer.
383            per_page: Number of bindings to return per page. Defaults to 25; maximum is 100.
384
385        Returns:
386            Paginated list of Slack channel bindings visible to the caller.
387        """
388        query: dict[str, object] = {}
389        if integration is not None:
390            query["integration"] = integration
391        if team is not None:
392            query["team"] = team
393        if agent is not None:
394            query["agent"] = agent
395        if org is not None:
396            query["org"] = org
397        if page is not None:
398            query["page"] = page
399        if per_page is not None:
400            query["per_page"] = per_page
401        return self._http.request(
402            "/api/v1/slack_channel_bindings",
403            query=query,
404            response_type=SlackChannelBindingListResponse,
405        )
406
407    def create(self, input: SlackChannelBindingCreateInput) -> SlackChannelBinding:
408        """
409        Create or update a Slack channel binding
410        Creates a new binding between a Slack channel and a team, or updates the
411        existing binding if one already exists for the given channel. The caller also
412        supplies a list of agents to attach to the binding and enroll as members of the
413        destination team.
414        The caller must have team-manage rights on the destination team (and on the
415        currently bound team if the channel is being re-pointed). Returns 403 if
416        permission is insufficient. All write steps are idempotent, so retrying after
417        a partial failure is safe.
418        On success the REST endpoint returns 201 Created. The script binding
419        (`slack.channel_bindings.upsert`) returns the full binding object including the
420        attached agents.
421
422        Args:
423            input: Request body.
424            input.agent_user_ids: List of agent user IDs to attach to the binding and enroll as members of the destination team. Pass an empty array to bind the channel without attaching any agents.
425            input.allow_bot_conversations: Opt this channel into sustained bot-to-bot conversation: the reply loop brake is disabled for its mirror thread. Set when the counterparty is a known bot the agent should keep answering. Omitting the parameter leaves the stored value unchanged.
426            input.channel_id: Slack channel ID to bind (e.g. `C01234ABCDE`). Acts as the natural key of the binding within the workspace.
427            input.customer_label: Human-readable label for the customer associated with this channel. Stored in the binding's config. `null` if omitted.
428            input.is_ext_shared_cached: Cached value of Slack's `is_ext_shared` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. `null` if omitted.
429            input.is_private_cached: Cached value of Slack's `is_private` flag for the channel. When provided, this value is persisted on the binding to avoid repeated Slack API lookups. Private channels are member-managed. `null` if omitted.
430            input.slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use.
431            input.team_id: ID of the team to bind the Slack channel to. The caller must have team-manage rights on this team.
432
433        Returns:
434            The created or updated Slack channel binding, including the full list of currently attached agents.
435        """
436        return self._http.request(
437            "/api/v1/slack_channel_bindings",
438            method="POST",
439            body=input,
440            response_type=SlackChannelBinding,
441        )
442
443    def provision(self, input: SlackChannelBindingProvisionInput) -> SlackChannelBinding:
444        """
445        Start adding a customer over Slack Connect
446        Opens a Slack Connect channel with a new customer creating one and sending
447        the invite, or adopting a shared channel you already have and records who is
448        adding whom so the addition can finish once the customer accepts.
449        The returned binding is **pending**: nothing mirrors, and no per-customer Team,
450        agent, or solution instance exists yet. Acceptance is asynchronous and may
451        never come. When it does, the addition completes in the background under the
452        identity of the admin who called this endpoint, re-checked live at that moment.
453        A caller who has since lost their admin role does not get a substitute the
454        addition is refused and a human re-adds the customer.
455        The caller must be an admin of the Slack integration's own organization. This
456        is the same authority the completion demands, checked here so a customer is
457        never invited into a channel whose addition can never finish.
458        Deliberately not exposed as a script binding: this sends mail to a person
459        outside the org, so it stays a vendor-admin HTTP surface.
460
461        Args:
462            input: Request body.
463            input.channel_name: Name for a Slack channel to create for this customer. Required unless `existing_channel_id` is given. The channel is created private.
464            input.customer_email: Address the Slack Connect invite is sent to. Required when creating a channel; optional when adopting one the customer is already in. Whoever accepts becomes the verified counterparty.
465            input.customer_key: The vendor's own primary key for this customer (`customer_id` / `account_id` / `tenant_id`). The per-customer agent's data access is locked to it. Immutable once the customer is added: re-targeting means offboarding and re-provisioning.
466            input.customer_label: Human-readable name for the customer (e.g. `Acme, Inc.`). Used for the vendor's own dashboards and as the per-customer Team's name. Not an identity or an access control input.
467            input.existing_channel_id: Adopt this already-shared Slack Connect channel (e.g. `C01234ABCDE`) instead of creating one. Mutually exclusive with `channel_name`.
468            input.inputs: String-keyed values the per-customer solution instance is stamped with. Defaults to an empty map.
469            input.slack_team_id: Slack workspace team ID of the vendor's own Slack installation (e.g. `T01234ABCDE`). The customer's workspace is not known yet it resolves from whoever accepts.
470            input.template_config_id: Config ID (`cfg_ `) of the org-installed Solution the per-customer instance is stamped from. Must be the organization's own installed copy, not the catalog original instances stamped from a different config do not appear in the vendor's customer fleet.
471
472        Returns:
473            The pending binding for the customer's channel. `disclosure_state` is `pending` until the customer accepts, and `scope_key` is null until the addition finishes.
474        """
475        return self._http.request(
476            "/api/v1/slack_channel_bindings/provision",
477            method="POST",
478            body=input,
479            response_type=SlackChannelBinding,
480        )
481
482    def delete(self, channel: str) -> SlackChannelBindingDeleteResponse:
483        """
484        Delete a Slack channel binding
485        Removes the binding between a Slack channel and its associated team. The
486        channel is identified by its Slack channel ID together with the `slack_team_id`
487        that scopes it to a specific Slack workspace. Removing the binding does not
488        delete the bound team or any conversation threads scoped to it; decommission
489        those resources separately if required.
490        The caller must have team-manage rights on the team the channel is currently
491        bound to. Returning 403 indicates insufficient permission; returning 404
492        indicates the binding does not exist or is not visible to the caller.
493        The REST endpoint returns 204 No Content on success. The script binding
494        (`slack.channel_bindings.delete`) returns a confirmation object so script
495        callers can verify success without an additional fetch. Both paths are
496        idempotent retrying after a partial failure is safe.
497
498        Args:
499            channel: Slack channel ID of the binding to delete (e.g. `C01234ABCDE`).
500
501        Returns:
502            Successful response
503        """
504        return self._http.request(
505            f"/api/v1/slack_channel_bindings/{channel}",
506            method="DELETE",
507            response_type=SlackChannelBindingDeleteResponse,
508        )
509
510    def get(self, channel: str, slack_team_id: str) -> SlackChannelBinding:
511        """
512        Retrieve a Slack channel binding
513        Returns the Slack channel binding identified by a Slack channel ID and workspace
514        team ID pair. Use this endpoint to look up the team and agents currently bound
515        to a specific Slack channel.
516        The `channel` path parameter is the Slack channel ID; `slack_team_id` identifies
517        the Slack workspace the channel belongs to, disambiguating channels with the same
518        ID across workspaces. Both parameters are required. Returns 404 if no binding
519        exists for the given pair or the associated Slack integration is not visible to
520        the caller.
521
522        Args:
523            channel: Slack channel ID of the binding to retrieve (e.g. `C01234ABCDE`).
524            slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Used together with `channel` to uniquely identify the binding.
525
526        Returns:
527            The Slack channel binding for the given channel and workspace.
528        """
529        query: dict[str, object] = {}
530        query["slack_team_id"] = slack_team_id
531        return self._http.request(
532            f"/api/v1/slack_channel_bindings/{channel}",
533            query=query,
534            response_type=SlackChannelBinding,
535        )
536
537    def delivery_outcomes(
538        self,
539        channel: str,
540        *,
541        since: str | None = None,
542        outcome: Literal["delivered", "floored", "judge_refused", "failed"] | None = None,
543        limit: int | None = None,
544        before_cursor: str | None = None,
545        after_cursor: str | None = None,
546    ) -> SlackDeliveryOutcomeListResponse:
547        """
548        List delivery outcomes for a Slack channel
549        Returns what happened to each agent message this platform sent to a Slack
550        channel, newest attempt first.
551        A message that never appears in a Slack channel has several possible causes
552        that look identical from the channel itself: a content guard withheld it, the
553        cross-org judge refused it, Slack rejected the call, or nobody asked anything.
554        This endpoint tells them apart. Use it to confirm a reply was delivered, or to
555        find out why one never arrived, without reading the channel's mirrored
556        conversation.
557        Outcomes cover **outbound agent messages only**. They carry no message
558        content, no author, and nothing about inbound messages. Access follows the
559        channel's binding the organization and app the channel is bound to and
560        needs no membership in the mirrored thread.
561        Paginated with opaque cursors, newest first. When `has_more` is true, pass the
562        response's `before_cursor` back as `before_cursor` to continue into older
563        history. `since` and `outcome` narrow the result set; they are filters, not
564        paging controls.
565
566        Args:
567            channel: Slack channel ID to read delivery outcomes for (e.g. `C01234ABCDE`).
568            since: Only return attempts at or after this ISO 8601 timestamp (e.g. `2026-08-11T00:00:00Z`). Omit to return the most recent attempts regardless of age.
569            outcome: Return only attempts with this outcome. Omit to return every outcome. Use `floored` and `judge_refused` to see only what was withheld.
570            limit: Maximum number of outcomes to return. Defaults to 50; maximum is 200.
571            before_cursor: Opaque cursor from a previous response; returns outcomes older than it. Cursors are not parseable and are only valid against this endpoint.
572            after_cursor: Opaque cursor from a previous response; returns outcomes newer than it. Suited to a UI loading newer entries. To poll for everything recorded since a point in time, prefer `since` with a little overlap and de-duplicate on `id` `after_cursor` can miss an attempt recorded in the same millisecond as the cursor's own row.
573
574        Returns:
575            Delivery outcomes for the requested channel, newest first.
576        """
577        query: dict[str, object] = {}
578        if since is not None:
579            query["since"] = since
580        if outcome is not None:
581            query["outcome"] = outcome
582        if limit is not None:
583            query["limit"] = limit
584        if before_cursor is not None:
585            query["before_cursor"] = before_cursor
586        if after_cursor is not None:
587            query["after_cursor"] = after_cursor
588        return self._http.request(
589            f"/api/v1/slack_channel_bindings/{channel}/delivery_outcomes",
590            query=query,
591            response_type=SlackDeliveryOutcomeListResponse,
592        )
593
594    def deposit_thread(
595        self, channel: str, input: SlackChannelBindingDepositThreadInput
596    ) -> SlackChannelBinding:
597        """
598        Point a Slack channel's deposit pipe at a staging thread, or turn it off
599        Sets the binding's deposit target the internal staging thread the
600        deposit pipe copies this channel's mirror content into. Pass a `null`
601        `thread_id` to turn the pipe off.
602        The target is validated server-side: it must exist, belong to the
603        binding's app and org, and never be a Slack mirror thread. Customer
604        bindings (bound `team_id`) additionally require a team-owned private
605        thread with no participant list, so the staging read ACL stays governed
606        by the channel-membership projection. Re-pointing or clearing an
607        existing target purges the old thread's deposit entries.
608
609        Args:
610            channel: Slack channel ID whose binding is being configured (e.g. `C01234ABCDE`).
611            input: Request body.
612            input.slack_team_id: Slack workspace team ID that the channel belongs to (e.g. `T01234ABCDE`). Identifies which Slack integration to use.
613            input.thread_id: Staging thread ID (primary key, `thr_ `) deposits should flow into. Pass `null` to turn the pipe off.
614
615        Returns:
616            The binding with the updated deposit config.
617        """
618        return self._http.request(
619            f"/api/v1/slack_channel_bindings/{channel}/deposit_thread",
620            method="POST",
621            body=input,
622            response_type=SlackChannelBinding,
623        )