Package ai.shipeasy.admin.api

Class KillswitchApi

java.lang.Object
ai.shipeasy.admin.api.KillswitchApi
public class KillswitchApi extends Object

  • Constructor Details

    • KillswitchApi

      public KillswitchApi()

    • KillswitchApi

      public KillswitchApi(ApiClient apiClient)

  • Method Details

    • getApiClient

      public ApiClient getApiClient()

    • setApiClient

      public void setApiClient(ApiClient apiClient)

    • getHostIndex

      public int getHostIndex()

    • setHostIndex

      public void setHostIndex(int hostIndex)

    • getCustomBaseUrl

      public String getCustomBaseUrl()

    • setCustomBaseUrl

      public void setCustomBaseUrl(String customBaseUrl)

    • createKillswitchCall

      public okhttp3.Call createKillswitchCall(@Nonnull CreateKillswitchRequest createKillswitchRequest, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for createKillswitch
      Parameters:
      createKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • createKillswitch

      public CreateKillswitchResponse createKillswitch(@Nonnull CreateKillswitchRequest createKillswitchRequest, @Nullable String xProjectId) throws ApiException
      Create a killswitch Creates a new killswitch with `value` (default `false`) applied to **every** env at version 1. Returns `409` if `name` already exists in the project. **Use cases** - **Untripped create** — `{ \"name\": \"payments.checkout\" }`. Provision the kill ahead of an incident. - **Pre-tripped** — `{ \"value\": true }` to ship the killswitch already engaged. - **With switches** — seed `switches` to carve out per-region/per-tenant kills from day one.
      Parameters:
      createKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      CreateKillswitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • createKillswitchWithHttpInfo

      public ApiResponse<CreateKillswitchResponse> createKillswitchWithHttpInfo(@Nonnull CreateKillswitchRequest createKillswitchRequest, @Nullable String xProjectId) throws ApiException
      Create a killswitch Creates a new killswitch with `value` (default `false`) applied to **every** env at version 1. Returns `409` if `name` already exists in the project. **Use cases** - **Untripped create** — `{ \"name\": \"payments.checkout\" }`. Provision the kill ahead of an incident. - **Pre-tripped** — `{ \"value\": true }` to ship the killswitch already engaged. - **With switches** — seed `switches` to carve out per-region/per-tenant kills from day one.
      Parameters:
      createKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<CreateKillswitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • createKillswitchAsync

      public okhttp3.Call createKillswitchAsync(@Nonnull CreateKillswitchRequest createKillswitchRequest, @Nullable String xProjectId, ApiCallback<CreateKillswitchResponse> _callback) throws ApiException
      Create a killswitch (asynchronously) Creates a new killswitch with `value` (default `false`) applied to **every** env at version 1. Returns `409` if `name` already exists in the project. **Use cases** - **Untripped create** — `{ \"name\": \"payments.checkout\" }`. Provision the kill ahead of an incident. - **Pre-tripped** — `{ \"value\": true }` to ship the killswitch already engaged. - **With switches** — seed `switches` to carve out per-region/per-tenant kills from day one.
      Parameters:
      createKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • deleteKillswitchCall

      public okhttp3.Call deleteKillswitchCall(@Nonnull String id, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for deleteKillswitch
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • deleteKillswitch

      public DeleteKillswitchResponse deleteKillswitch(@Nonnull String id, @Nullable String xProjectId) throws ApiException
      Delete a killswitch Soft-deletes the killswitch and rebuilds the project's flags KV blob so SDKs stop seeing it. **Use case:** Tear down a killswitch after the feature it protected has been removed.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      DeleteKillswitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • deleteKillswitchWithHttpInfo

      public ApiResponse<DeleteKillswitchResponse> deleteKillswitchWithHttpInfo(@Nonnull String id, @Nullable String xProjectId) throws ApiException
      Delete a killswitch Soft-deletes the killswitch and rebuilds the project's flags KV blob so SDKs stop seeing it. **Use case:** Tear down a killswitch after the feature it protected has been removed.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<DeleteKillswitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • deleteKillswitchAsync

      public okhttp3.Call deleteKillswitchAsync(@Nonnull String id, @Nullable String xProjectId, ApiCallback<DeleteKillswitchResponse> _callback) throws ApiException
      Delete a killswitch (asynchronously) Soft-deletes the killswitch and rebuilds the project's flags KV blob so SDKs stop seeing it. **Use case:** Tear down a killswitch after the feature it protected has been removed.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • getKillswitchCall

      public okhttp3.Call getKillswitchCall(@Nonnull String id, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for getKillswitch
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • getKillswitch

      public GetKillswitchResponse getKillswitch(@Nonnull String id, @Nullable String xProjectId) throws ApiException
      Get one killswitch Returns the killswitch metadata plus the latest published `value`/`switches`/`version` per env. **Use case:** Fetch the current state of one killswitch — e.g. to verify a trip propagated before declaring an incident mitigated.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      GetKillswitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • getKillswitchWithHttpInfo

      public ApiResponse<GetKillswitchResponse> getKillswitchWithHttpInfo(@Nonnull String id, @Nullable String xProjectId) throws ApiException
      Get one killswitch Returns the killswitch metadata plus the latest published `value`/`switches`/`version` per env. **Use case:** Fetch the current state of one killswitch — e.g. to verify a trip propagated before declaring an incident mitigated.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<GetKillswitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • getKillswitchAsync

      public okhttp3.Call getKillswitchAsync(@Nonnull String id, @Nullable String xProjectId, ApiCallback<GetKillswitchResponse> _callback) throws ApiException
      Get one killswitch (asynchronously) Returns the killswitch metadata plus the latest published `value`/`switches`/`version` per env. **Use case:** Fetch the current state of one killswitch — e.g. to verify a trip propagated before declaring an incident mitigated.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • listKillswitchesCall

      public okhttp3.Call listKillswitchesCall(@Nullable String xProjectId, @Nullable Integer limit, @Nullable String cursor, @Nullable String q, ApiCallback _callback) throws ApiException
      Build call for listKillswitches
      Parameters:
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      limit - Page size (1–500). Defaults to 100. (optional, default to 100)
      cursor - Opaque cursor returned in the previous page's `next_cursor`. Omit for the first page. (optional)
      q - Case-insensitive substring filter across the resource's human-readable text columns (e.g. `name`, `title`, `description`). OR-matched across those columns; omit to return everything. (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • listKillswitches

      public ListKillswitchesResponse listKillswitches(@Nullable String xProjectId, @Nullable Integer limit, @Nullable String cursor, @Nullable String q) throws ApiException
      List killswitches Returns a single page of killswitches ordered by `updated_at desc, id desc`. Each row includes the latest published `value`/`switches`/`version` per env. **Use case:** Snapshot every killswitch in the project — e.g. to render an incident-response runbook listing every kill and its current trip state.
      Parameters:
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      limit - Page size (1–500). Defaults to 100. (optional, default to 100)
      cursor - Opaque cursor returned in the previous page's `next_cursor`. Omit for the first page. (optional)
      q - Case-insensitive substring filter across the resource's human-readable text columns (e.g. `name`, `title`, `description`). OR-matched across those columns; omit to return everything. (optional)
      Returns:
      ListKillswitchesResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • listKillswitchesWithHttpInfo

      public ApiResponse<ListKillswitchesResponse> listKillswitchesWithHttpInfo(@Nullable String xProjectId, @Nullable Integer limit, @Nullable String cursor, @Nullable String q) throws ApiException
      List killswitches Returns a single page of killswitches ordered by `updated_at desc, id desc`. Each row includes the latest published `value`/`switches`/`version` per env. **Use case:** Snapshot every killswitch in the project — e.g. to render an incident-response runbook listing every kill and its current trip state.
      Parameters:
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      limit - Page size (1–500). Defaults to 100. (optional, default to 100)
      cursor - Opaque cursor returned in the previous page's `next_cursor`. Omit for the first page. (optional)
      q - Case-insensitive substring filter across the resource's human-readable text columns (e.g. `name`, `title`, `description`). OR-matched across those columns; omit to return everything. (optional)
      Returns:
      ApiResponse<ListKillswitchesResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • listKillswitchesAsync

      public okhttp3.Call listKillswitchesAsync(@Nullable String xProjectId, @Nullable Integer limit, @Nullable String cursor, @Nullable String q, ApiCallback<ListKillswitchesResponse> _callback) throws ApiException
      List killswitches (asynchronously) Returns a single page of killswitches ordered by `updated_at desc, id desc`. Each row includes the latest published `value`/`switches`/`version` per env. **Use case:** Snapshot every killswitch in the project — e.g. to render an incident-response runbook listing every kill and its current trip state.
      Parameters:
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      limit - Page size (1–500). Defaults to 100. (optional, default to 100)
      cursor - Opaque cursor returned in the previous page's `next_cursor`. Omit for the first page. (optional)
      q - Case-insensitive substring filter across the resource's human-readable text columns (e.g. `name`, `title`, `description`). OR-matched across those columns; omit to return everything. (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • setKillswitchSwitchCall

      public okhttp3.Call setKillswitchSwitchCall(@Nonnull String id, @Nonnull SetKillswitchSwitchRequest setKillswitchSwitchRequest, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for setKillswitchSwitch
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • setKillswitchSwitch

      public SetKillswitchSwitchResponse setKillswitchSwitch(@Nonnull String id, @Nonnull SetKillswitchSwitchRequest setKillswitchSwitchRequest, @Nullable String xProjectId) throws ApiException
      Set one switch entry Sets or updates a single `switchKey` on a single `env`. Publishes one new version on that env only — other envs untouched. Use this for surgical per-env, per-key flips during incident response (e.g. trip `eu_region` on prod without touching the flat `value` or other envs). **Use cases** - **Trip a region** — `{ \"env\": \"prod\", \"switchKey\": \"eu_region\", \"value\": true }`. - **Untrip without removing** — same payload with `value: false`. To remove the entry entirely use `DELETE /{id}/switch`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      SetKillswitchSwitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • setKillswitchSwitchWithHttpInfo

      public ApiResponse<SetKillswitchSwitchResponse> setKillswitchSwitchWithHttpInfo(@Nonnull String id, @Nonnull SetKillswitchSwitchRequest setKillswitchSwitchRequest, @Nullable String xProjectId) throws ApiException
      Set one switch entry Sets or updates a single `switchKey` on a single `env`. Publishes one new version on that env only — other envs untouched. Use this for surgical per-env, per-key flips during incident response (e.g. trip `eu_region` on prod without touching the flat `value` or other envs). **Use cases** - **Trip a region** — `{ \"env\": \"prod\", \"switchKey\": \"eu_region\", \"value\": true }`. - **Untrip without removing** — same payload with `value: false`. To remove the entry entirely use `DELETE /{id}/switch`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<SetKillswitchSwitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • setKillswitchSwitchAsync

      public okhttp3.Call setKillswitchSwitchAsync(@Nonnull String id, @Nonnull SetKillswitchSwitchRequest setKillswitchSwitchRequest, @Nullable String xProjectId, ApiCallback<SetKillswitchSwitchResponse> _callback) throws ApiException
      Set one switch entry (asynchronously) Sets or updates a single `switchKey` on a single `env`. Publishes one new version on that env only — other envs untouched. Use this for surgical per-env, per-key flips during incident response (e.g. trip `eu_region` on prod without touching the flat `value` or other envs). **Use cases** - **Trip a region** — `{ \"env\": \"prod\", \"switchKey\": \"eu_region\", \"value\": true }`. - **Untrip without removing** — same payload with `value: false`. To remove the entry entirely use `DELETE /{id}/switch`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • setKillswitchValueCall

      public okhttp3.Call setKillswitchValueCall(@Nonnull String id, @Nonnull SetKillswitchValueRequest setKillswitchValueRequest, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for setKillswitchValue
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchValueRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • setKillswitchValue

      public SetKillswitchValueResponse setKillswitchValue(@Nonnull String id, @Nonnull SetKillswitchValueRequest setKillswitchValueRequest, @Nullable String xProjectId) throws ApiException
      Set the flat value on one env Sets the flat `value` on a single `env`, publishing one new version on that env only. `switches` and other envs are untouched. Use this to trip (or untrip) a killswitch on one environment without replacing its per-key overrides. **Use cases** - **Trip on prod** — `{ \"env\": \"prod\", \"value\": true }`. - **Untrip on prod** — `{ \"env\": \"prod\", \"value\": false }`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchValueRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      SetKillswitchValueResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • setKillswitchValueWithHttpInfo

      public ApiResponse<SetKillswitchValueResponse> setKillswitchValueWithHttpInfo(@Nonnull String id, @Nonnull SetKillswitchValueRequest setKillswitchValueRequest, @Nullable String xProjectId) throws ApiException
      Set the flat value on one env Sets the flat `value` on a single `env`, publishing one new version on that env only. `switches` and other envs are untouched. Use this to trip (or untrip) a killswitch on one environment without replacing its per-key overrides. **Use cases** - **Trip on prod** — `{ \"env\": \"prod\", \"value\": true }`. - **Untrip on prod** — `{ \"env\": \"prod\", \"value\": false }`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchValueRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<SetKillswitchValueResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • setKillswitchValueAsync

      public okhttp3.Call setKillswitchValueAsync(@Nonnull String id, @Nonnull SetKillswitchValueRequest setKillswitchValueRequest, @Nullable String xProjectId, ApiCallback<SetKillswitchValueResponse> _callback) throws ApiException
      Set the flat value on one env (asynchronously) Sets the flat `value` on a single `env`, publishing one new version on that env only. `switches` and other envs are untouched. Use this to trip (or untrip) a killswitch on one environment without replacing its per-key overrides. **Use cases** - **Trip on prod** — `{ \"env\": \"prod\", \"value\": true }`. - **Untrip on prod** — `{ \"env\": \"prod\", \"value\": false }`.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      setKillswitchValueRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • unsetKillswitchSwitchCall

      public okhttp3.Call unsetKillswitchSwitchCall(@Nonnull String id, @Nonnull UnsetKillswitchSwitchRequest unsetKillswitchSwitchRequest, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for unsetKillswitchSwitch
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      unsetKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • unsetKillswitchSwitch

      public UnsetKillswitchSwitchResponse unsetKillswitchSwitch(@Nonnull String id, @Nonnull UnsetKillswitchSwitchRequest unsetKillswitchSwitchRequest, @Nullable String xProjectId) throws ApiException
      Remove one switch entry Removes a single `switchKey` from the `switches` map on a single `env`. Publishes a new version on that env. Returns `{ removed: false }` if the entry didn't exist (idempotent no-op). **Use case:** Clean up a per-region override after the incident is resolved so the flat `value` governs again.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      unsetKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      UnsetKillswitchSwitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • unsetKillswitchSwitchWithHttpInfo

      public ApiResponse<UnsetKillswitchSwitchResponse> unsetKillswitchSwitchWithHttpInfo(@Nonnull String id, @Nonnull UnsetKillswitchSwitchRequest unsetKillswitchSwitchRequest, @Nullable String xProjectId) throws ApiException
      Remove one switch entry Removes a single `switchKey` from the `switches` map on a single `env`. Publishes a new version on that env. Returns `{ removed: false }` if the entry didn't exist (idempotent no-op). **Use case:** Clean up a per-region override after the incident is resolved so the flat `value` governs again.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      unsetKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<UnsetKillswitchSwitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • unsetKillswitchSwitchAsync

      public okhttp3.Call unsetKillswitchSwitchAsync(@Nonnull String id, @Nonnull UnsetKillswitchSwitchRequest unsetKillswitchSwitchRequest, @Nullable String xProjectId, ApiCallback<UnsetKillswitchSwitchResponse> _callback) throws ApiException
      Remove one switch entry (asynchronously) Removes a single `switchKey` from the `switches` map on a single `env`. Publishes a new version on that env. Returns `{ removed: false }` if the entry didn't exist (idempotent no-op). **Use case:** Clean up a per-region override after the incident is resolved so the flat `value` governs again.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      unsetKillswitchSwitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object

    • updateKillswitchCall

      public okhttp3.Call updateKillswitchCall(@Nonnull String id, @Nonnull UpdateKillswitchRequest updateKillswitchRequest, @Nullable String xProjectId, ApiCallback _callback) throws ApiException
      Build call for updateKillswitch
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      updateKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - Callback for upload/download progress
      Returns:
      Call to execute
      Throws:
      ApiException - If fail to serialize the request body object

    • updateKillswitch

      public UpdateKillswitchResponse updateKillswitch(@Nonnull String id, @Nonnull UpdateKillswitchRequest updateKillswitchRequest, @Nullable String xProjectId) throws ApiException
      Update a killswitch Partial update applied to **every** env. Setting `value`/`switches` publishes a new version per env. Description-only patches don't bump versions. To change a single switch on a single env, use `PUT /{id}/switch` instead. **Use cases** - **Trip everywhere** — `{ \"value\": true }`. Kills the feature across dev/stage/prod in one call. - **Untrip everywhere** — `{ \"value\": false }`. - **Replace switches** — send the full new map; per-key edits use `PUT /{id}/switch`. - **Update description** — metadata-only patches don't bump versions.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      updateKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      UpdateKillswitchResponse
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • updateKillswitchWithHttpInfo

      public ApiResponse<UpdateKillswitchResponse> updateKillswitchWithHttpInfo(@Nonnull String id, @Nonnull UpdateKillswitchRequest updateKillswitchRequest, @Nullable String xProjectId) throws ApiException
      Update a killswitch Partial update applied to **every** env. Setting `value`/`switches` publishes a new version per env. Description-only patches don't bump versions. To change a single switch on a single env, use `PUT /{id}/switch` instead. **Use cases** - **Trip everywhere** — `{ \"value\": true }`. Kills the feature across dev/stage/prod in one call. - **Untrip everywhere** — `{ \"value\": false }`. - **Replace switches** — send the full new map; per-key edits use `PUT /{id}/switch`. - **Update description** — metadata-only patches don't bump versions.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      updateKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      Returns:
      ApiResponse<UpdateKillswitchResponse>
      Throws:
      ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

    • updateKillswitchAsync

      public okhttp3.Call updateKillswitchAsync(@Nonnull String id, @Nonnull UpdateKillswitchRequest updateKillswitchRequest, @Nullable String xProjectId, ApiCallback<UpdateKillswitchResponse> _callback) throws ApiException
      Update a killswitch (asynchronously) Partial update applied to **every** env. Setting `value`/`switches` publishes a new version per env. Description-only patches don't bump versions. To change a single switch on a single env, use `PUT /{id}/switch` instead. **Use cases** - **Trip everywhere** — `{ \"value\": true }`. Kills the feature across dev/stage/prod in one call. - **Untrip everywhere** — `{ \"value\": false }`. - **Replace switches** — send the full new map; per-key edits use `PUT /{id}/switch`. - **Update description** — metadata-only patches don't bump versions.
      Parameters:
      id - Stable opaque killswitch id (`ksw_…`) or the killswitch's `name`. (required)
      updateKillswitchRequest - (required)
      xProjectId - Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it). (optional)
      _callback - The callback to be executed when the API call finishes
      Returns:
      The request call
      Throws:
      ApiException - If fail to process the API call, e.g. serializing the request body object