pangea-sdk 6.2.0b1__py3-none-any.whl → 6.3.0__py3-none-any.whl

pangea/asyncio/services/audit.py

@@ -1,11 +1,14 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Modernize.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import datetime
-from typing import Any, Dict, Iterable, List, Literal, Optional, Sequence, Union, cast, overload
-
-from pydantic import TypeAdapter
+from collections.abc import Mapping
+from typing import Any, Dict, Iterable, List, Optional, Sequence, Union
 
 import pangea.exceptions as pexc
 from pangea.asyncio.services.base import ServiceBaseAsync
@@ -14,13 +17,11 @@ from pangea.response import PangeaResponse, PangeaResponseResult
 from pangea.services.audit.audit import AuditBase
 from pangea.services.audit.exceptions import AuditException
 from pangea.services.audit.models import (
-    AuditSchema,
     DownloadFormat,
     DownloadRequest,
     DownloadResult,
     Event,
     ExportRequest,
-    ForwardingConfiguration,
     LogBulkResult,
     LogResult,
     PublishedRoot,
@@ -33,9 +34,6 @@ from pangea.services.audit.models import (
     SearchRequest,
     SearchResultOutput,
     SearchResultRequest,
-    ServiceConfig,
-    ServiceConfigFilter,
-    ServiceConfigListResult,
 )
 from pangea.services.audit.util import format_datetime
 
@@ -70,7 +68,7 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
         token: str,
         config: PangeaConfig | None = None,
         private_key_file: str = "",
-        public_key_info: dict[str, str] = {},
+        public_key_info: Mapping[str, str] = {},
         tenant_id: str | None = None,
         logger_name: str = "pangea",
         config_id: str | None = None,
@@ -142,7 +140,7 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
             A PangeaResponse where the hash of event data and optional verbose
                 results are returned in the response.result field.
                 Available response fields can be found in our
-                [API documentation](https://pangea.cloud/docs/api/audit#log-an-entry).
+                [API documentation](https://pangea.cloud/docs/api/audit#/v1/log-post).
 
         Examples:
             try:
@@ -193,7 +191,7 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
         Returns:
             A PangeaResponse where the hash of event data and optional verbose
                 results are returned in the response.result field.
-                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#log-an-entry).
+                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#/v1/log-post).
 
         Examples:
             response = await audit.log_event({"message": "hello world"}, verbose=True)
@@ -229,7 +227,7 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
         Returns:
             A PangeaResponse where the hash of event data and optional verbose
                 results are returned in the response.result field.
-                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#log-an-entry).
+                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#/v1/log-post).
 
         Examples:
             FIXME:
@@ -266,7 +264,7 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
         Returns:
             A PangeaResponse where the hash of event data and optional verbose
                 results are returned in the response.result field.
-                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#log-an-entry).
+                Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#/v1/log-post).
 
         Examples:
             FIXME:
@@ -335,8 +333,8 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
 
         Returns:
             A PangeaResponse[SearchOutput] where the first page of matched events is returned in the
-                response.result field. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#search-for-events).
-                Pagination can be found in the [search results endpoint](https://pangea.cloud/docs/api/audit#search-results).
+                response.result field. Available response fields can be found in our [API documentation](https://pangea.cloud/docs/api/audit#/v1/results-post).
+                Pagination can be found in the [search results endpoint](https://pangea.cloud/docs/api/audit#/v1/download_results-post).
 
         Examples:
             response: PangeaResponse[SearchOutput] = audit.search(query="message:test", search_restriction={'source': ["monitor"]}, limit=1, verify_consistency=True, verify_events=True)
@@ -597,298 +595,6 @@ class AuditAsync(ServiceBaseAsync, AuditBase):
         )
         return await self.request.post("v1/download_results", DownloadResult, data=input.model_dump(exclude_none=True))
 
-    async def get_service_config(self, config_id: str) -> PangeaResponse[ServiceConfig]:
-        """
-        Get a service config.
-
-        OperationId: audit_post_v1beta_config
-
-        Args:
-            id: The config ID
-        """
-
-        response = await self.request.post("v1beta/config", PangeaResponseResult, data={"id": config_id})
-        response.result = TypeAdapter(ServiceConfig).validate_python(response.json["result"])
-        return cast(PangeaResponse[ServiceConfig], response)
-
-    @overload
-    async def create_service_config(
-        self,
-        version: Literal[1],
-        name: str,
-        *,
-        cold_query_result_retention: str | None = None,
-        hot_storage: str | None = None,
-        query_result_retention: str | None = None,
-        redact_service_config_id: str | None = None,
-        redaction_fields: Sequence[str] | None = None,
-        retention: str | None = None,
-        vault_key_id: str | None = None,
-        vault_service_config_id: str | None = None,
-        vault_sign: bool | None = None,
-    ) -> PangeaResponse[ServiceConfig]:
-        """
-        Create a v1 service config.
-
-        OperationId: audit_post_v1beta_config_create
-
-        Args:
-            name: Configuration name
-            cold_query_result_retention: Retention window for cold query result / state information.
-            hot_storage: Retention window to keep audit logs in hot storage.
-            query_result_retention: Length of time to preserve server-side query result caching.
-            redact_service_config_id: A redact service config that will be used to redact PII from logs.
-            redaction_fields: Fields to perform redaction against.
-            retention: Retention window to store audit logs.
-            vault_key_id: ID of the Vault key used for signing. If missing, use a default Audit key.
-            vault_service_config_id: A vault service config that will be used to sign logs.
-            vault_sign: Enable/disable event signing.
-        """
-
-    @overload
-    async def create_service_config(
-        self,
-        version: Literal[2],
-        name: str,
-        *,
-        schema: AuditSchema,
-        cold_query_result_retention: str | None = None,
-        forwarding_configuration: ForwardingConfiguration | None = None,
-        hot_storage: str | None = None,
-        query_result_retention: str | None = None,
-        redact_service_config_id: str | None = None,
-        retention: str | None = None,
-        vault_key_id: str | None = None,
-        vault_service_config_id: str | None = None,
-        vault_sign: bool | None = None,
-    ) -> PangeaResponse[ServiceConfig]:
-        """
-        Create a v2 service config.
-
-        OperationId: audit_post_v1beta_config_create
-
-        Args:
-            name: Configuration name
-            schema: Audit log field configuration. Only settable at create time.
-            cold_query_result_retention: Retention window for cold query result / state information.
-            forwarding_configuration: Configuration for forwarding audit logs to external systems.
-            hot_storage: Retention window to keep audit logs in hot storage.
-            query_result_retention: Length of time to preserve server-side query result caching.
-            redact_service_config_id: A redact service config that will be used to redact PII from logs.
-            retention: Retention window to store audit logs.
-            vault_key_id: ID of the Vault key used for signing. If missing, use a default Audit key.
-            vault_service_config_id: A vault service config that will be used to sign logs.
-            vault_sign: Enable/disable event signing.
-        """
-
-    @overload
-    async def create_service_config(
-        self,
-        version: Literal[3],
-        name: str,
-        *,
-        schema: AuditSchema,
-        cold_storage: str | None = None,
-        hot_storage: str | None = None,
-        warm_storage: str | None = None,
-        redact_service_config_id: str | None = None,
-        vault_service_config_id: str | None = None,
-        vault_key_id: str | None = None,
-        vault_sign: bool | None = None,
-        forwarding_configuration: ForwardingConfiguration | None = None,
-    ) -> PangeaResponse[ServiceConfig]:
-        """
-        Create a v3 service config.
-
-        OperationId: audit_post_v1beta_config_create
-
-        Args:
-            name: Configuration name
-            schema: Audit log field configuration. Only settable at create time.
-            cold_storage: Retention window for logs in cold storage. Deleted afterwards.
-            hot_storage: Retention window for logs in hot storage. Migrated to warm, cold, or deleted afterwards.
-            warm_storage: Retention window for logs in warm storage. Migrated to cold or deleted afterwards.
-            redact_service_config_id: A redact service config that will be used to redact PII from logs.
-            vault_service_config_id: A vault service config that will be used to sign logs.
-            vault_key_id: ID of the Vault key used for signing. If missing, use a default Audit key.
-            vault_sign: Enable/disable event signing.
-            forwarding_configuration: Configuration for forwarding audit logs to external systems.
-        """
-
-    async def create_service_config(
-        self,
-        version: Literal[1, 2, 3],
-        name: str,
-        *,
-        cold_query_result_retention: str | None = None,
-        cold_storage: str | None = None,
-        forwarding_configuration: ForwardingConfiguration | None = None,
-        hot_storage: str | None = None,
-        query_result_retention: str | None = None,
-        redact_service_config_id: str | None = None,
-        redaction_fields: Sequence[str] | None = None,
-        retention: str | None = None,
-        schema: AuditSchema | None = None,
-        vault_key_id: str | None = None,
-        vault_service_config_id: str | None = None,
-        vault_sign: bool | None = None,
-        warm_storage: str | None = None,
-    ) -> PangeaResponse[ServiceConfig]:
-        """
-        Create a service config.
-
-        OperationId: audit_post_v1beta_config_create
-
-        Args:
-            name: Configuration name
-            cold_query_result_retention: Retention window for cold query result / state information.
-            cold_storage: Retention window for logs in cold storage. Deleted afterwards.
-            forwarding_configuration: Configuration for forwarding audit logs to external systems.
-            hot_storage: Retention window to keep audit logs in hot storage.
-            query_result_retention: Length of time to preserve server-side query result caching.
-            redact_service_config_id: A redact service config that will be used to redact PII from logs.
-            redaction_fields: Fields to perform redaction against.
-            retention: Retention window to store audit logs.
-            schema: Audit log field configuration. Only settable at create time.
-            vault_key_id: ID of the Vault key used for signing. If missing, use a default Audit key.
-            vault_service_config_id: A vault service config that will be used to sign logs.
-            vault_sign: Enable/disable event signing.
-            warm_storage: Retention window for logs in warm storage. Migrated to cold or deleted afterwards.
-        """
-
-        response = await self.request.post(
-            "v1beta/config/create",
-            PangeaResponseResult,
-            data={
-                "cold_query_result_retention": cold_query_result_retention,
-                "cold_storage": cold_storage,
-                "forwarding_configuration": forwarding_configuration,
-                "hot_storage": hot_storage,
-                "name": name,
-                "query_result_retention": query_result_retention,
-                "redact_service_config_id": redact_service_config_id,
-                "redaction_fields": redaction_fields,
-                "retention": retention,
-                "schema": schema,
-                "vault_key_id": vault_key_id,
-                "vault_service_config_id": vault_service_config_id,
-                "vault_sign": vault_sign,
-                "warm_storage": warm_storage,
-                "version": version,
-            },
-        )
-        response.result = TypeAdapter(ServiceConfig).validate_python(response.json["result"])
-        return cast(PangeaResponse[ServiceConfig], response)
-
-    async def update_service_config(
-        self,
-        config_id: str,
-        *,
-        name: str,
-        updated_at: datetime.datetime,
-        # Optionals.
-        cold_query_result_retention: str | None = None,
-        cold_storage: str | None = None,
-        forwarding_configuration: ForwardingConfiguration | None = None,
-        hot_storage: str | None = None,
-        query_result_retention: str | None = None,
-        redact_service_config_id: str | None = None,
-        retention: str | None = None,
-        schema: AuditSchema | None = None,
-        vault_key_id: str | None = None,
-        vault_service_config_id: str | None = None,
-        vault_sign: bool | None = None,
-        warm_storage: str | None = None,
-    ) -> PangeaResponse[ServiceConfig]:
-        """
-        Update a service config.
-
-        OperationId: audit_post_v1beta_config_update
-
-        Args:
-            id: The config ID
-            name: Configuration name
-            updated_at: The DB timestamp when this config was last updated at
-            cold_query_result_retention: Retention window for cold query result / state information.
-            cold_storage: Retention window for logs in cold storage. Deleted afterwards.
-            forwarding_configuration: Configuration for forwarding audit logs to external systems
-            hot_storage: Retention window to keep audit logs in hot storage
-            query_result_retention: Length of time to preserve server-side query result caching
-            redact_service_config_id: A redact service config that will be used to redact PII from logs
-            retention: Retention window to store audit logs
-            schema: Audit log field configuration
-            vault_key_id: ID of the Vault key used for signing. If missing, use a default Audit key.
-            vault_service_config_id: A vault service config that will be used to sign logs
-            vault_sign: Enable/disable event signing
-            warm_storage: Retention window for logs in warm storage. Migrated to cold or deleted afterwards.
-        """
-
-        response = await self.request.post(
-            "v1beta/config/update",
-            PangeaResponseResult,
-            data={
-                "id": config_id,
-                "name": name,
-                "updated_at": updated_at,
-                # Optionals.
-                "cold_query_result_retention": cold_query_result_retention,
-                "cold_storage": cold_storage,
-                "forwarding_configuration": forwarding_configuration,
-                "hot_storage": hot_storage,
-                "query_result_retention": query_result_retention,
-                "redact_service_config_id": redact_service_config_id,
-                "retention": retention,
-                "schema": schema,
-                "vault_key_id": vault_key_id,
-                "vault_service_config_id": vault_service_config_id,
-                "vault_sign": vault_sign,
-                "warm_storage": warm_storage,
-            },
-        )
-        response.result = TypeAdapter(ServiceConfig).validate_python(response.json["result"])
-        return cast(PangeaResponse[ServiceConfig], response)
-
-    async def delete_service_config(self, config_id: str) -> PangeaResponse[ServiceConfig]:
-        """
-        Delete a service config.
-
-        OperationId: audit_post_v1beta_config_delete
-
-        Args:
-            id: The config ID
-        """
-
-        response = await self.request.post("v1beta/config/delete", PangeaResponseResult, data={"id": config_id})
-        response.result = TypeAdapter(ServiceConfig).validate_python(response.json["result"])
-        return cast(PangeaResponse[ServiceConfig], response)
-
-    async def list_service_configs(
-        self,
-        *,
-        filter: ServiceConfigFilter | None = None,
-        last: str | None = None,
-        order: Literal["asc", "desc"] | None = None,
-        order_by: Literal["id", "created_at", "updated_at"] | None = None,
-        size: int | None = None,
-    ) -> PangeaResponse[ServiceConfigListResult]:
-        """
-        List service configs.
-
-        OperationId: audit_post_v1beta_config_list
-
-        Args:
-            last: Reflected value from a previous response to obtain the next page of results.
-            order: Order results asc(ending) or desc(ending).
-            order_by: Which field to order results by.
-            size: Maximum results to include in the response.
-        """
-
-        return await self.request.post(
-            "v1beta/config/list",
-            ServiceConfigListResult,
-            data={"filter": filter, "last": last, "order": order, "order_by": order_by, "size": size},
-        )
-
     async def update_published_roots(self, result: SearchResultOutput):
         """Fetches series of published root hashes from Arweave
 

pangea/asyncio/services/authn.py

@@ -1,7 +1,12 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Modernize.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
+from collections.abc import Mapping
 from typing import Dict, List, Literal, Optional, Union
 
 import pangea.services.authn.models as m
@@ -127,7 +132,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a list of sessions in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/session/list).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/session/list-post).
 
             Examples:
                 response = authn.session.list()
@@ -192,7 +197,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with credentials for a login session in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/client/userinfo).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/client/userinfo-post).
 
             Examples:
                 response = authn.client.userinfo(
@@ -217,7 +222,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with jwt verification keys in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/jwt#/v2/client/jwks).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/jwt#/v2/client/jwks-post).
 
             Examples:
                 response = authn.client.jwks()
@@ -290,7 +295,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with a list of sessions in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/client/session/list).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/client/session/list-post).
 
                 Examples:
                     response = authn.client.session.list(
@@ -348,7 +353,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with credentials for a login session in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/client/session/refresh).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/session#/v2/client/session/refresh-post).
 
                 Examples:
                     response = authn.client.session.refresh(
@@ -432,7 +437,7 @@ class AuthNAsync(ServiceBaseAsync):
             ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
-            async def check(self, token: str) -> PangeaResponse[m.ClientTokenCheckResult]:
+            async def check(self, token: m.Token) -> PangeaResponse[m.ClientTokenCheckResult]:
                 """
                 Check a token
 
@@ -441,22 +446,19 @@ class AuthNAsync(ServiceBaseAsync):
                 OperationId: authn_post_v2_client_token_check
 
                 Args:
-                    token (str): A token value
+                    token: A token value
 
                 Returns:
                     A PangeaResponse with a token and its information in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/client/token/check).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/client/token/check-post).
 
                 Examples:
-                    response = authn.client.token_endpoints.check(
+                    response = await authn.client.token_endpoints.check(
                         token="ptu_wuk7tvtpswyjtlsx52b7yyi2l7zotv4a",
                     )
                 """
-                input = m.ClientTokenCheckRequest(token=token)
-                return await self.request.post(
-                    "v2/client/token/check", m.ClientTokenCheckResult, data=input.model_dump(exclude_none=True)
-                )
+                return await self.request.post("v2/client/token/check", m.ClientTokenCheckResult, data={"token": token})
 
     class UserAsync(ServiceBaseAsync):
         service_name = _SERVICE_NAME
@@ -475,7 +477,7 @@ class AuthNAsync(ServiceBaseAsync):
         async def create(
             self,
             email: str,
-            profile: m.Profile,
+            profile: Mapping[str, str],
             *,
             username: str | None = None,
         ) -> PangeaResponse[m.UserCreateResult]:
@@ -494,7 +496,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a user and its information in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/create).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/create-post).
 
             Examples:
                 response = authn.user.create(
@@ -563,7 +565,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a pending user invitation in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/invite#/v2/user/invite).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/invite#/v2/user/invite-post).
 
             Examples:
                 response = authn.user.invite(
@@ -608,7 +610,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a user and its information in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/update).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/update-post).
 
             Examples:
                 response = authn.user.update(
@@ -652,7 +654,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a list of users in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/list).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/list-post).
 
             Examples:
                 response = authn.user.list()
@@ -705,7 +707,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with a list of pending user invitations in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/invite#/v2/user/invite/list).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/invite#/v2/user/invite/list-post).
                 Examples:
                     response = authn.user.invites.list()
                 """
@@ -809,7 +811,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with a list of authenticators in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/authenticators/list).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/authenticators/list-post).
 
                 Examples:
                     response = authn.user.authenticators.list(
@@ -852,7 +854,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with a user and its information in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/profile/get).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/profile/get-post).
 
                 Examples:
                     response = authn.user.profile.get(
@@ -866,7 +868,7 @@ class AuthNAsync(ServiceBaseAsync):
 
             async def update(
                 self,
-                profile: m.Profile,
+                profile: Mapping[str, str],
                 id: str | None = None,
                 email: str | None = None,
                 *,
@@ -888,7 +890,7 @@ class AuthNAsync(ServiceBaseAsync):
                 Returns:
                     A PangeaResponse with a user and its information in the response.result field.
                         Available response fields can be found in our
-                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/profile/update).
+                        [API Documentation](https://pangea.cloud/docs/api/authn/user#/v2/user/profile/update-post).
 
                 Examples:
                     response = authn.user.profile.update(
@@ -982,7 +984,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with credentials for a login session in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/complete).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/complete-post).
 
             Examples:
                 response = authn.flow.complete(
@@ -995,7 +997,10 @@ class AuthNAsync(ServiceBaseAsync):
             )
 
         async def restart(
-            self, flow_id: str, choice: m.FlowChoice, data: m.FlowRestartData = {}
+            self,
+            flow_id: str,
+            choice: m.FlowChoice,
+            data: m.FlowRestartData = {},  # noqa: B006
         ) -> PangeaResponse[m.FlowRestartResult]:
             """
             Restart a sign-up/sign-in flow
@@ -1013,7 +1018,7 @@ class AuthNAsync(ServiceBaseAsync):
                 A PangeaResponse with information about next steps needed
                     to complete a flow in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/restart).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/restart-post).
 
             Examples:
                 response = authn.flow.restart(
@@ -1052,7 +1057,7 @@ class AuthNAsync(ServiceBaseAsync):
                 A PangeaResponse with information about next steps needed
                     to complete a flow in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/start).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/start-post).
 
             Examples:
                 response = authn.flow.start(
@@ -1068,7 +1073,10 @@ class AuthNAsync(ServiceBaseAsync):
             return await self.request.post("v2/flow/start", m.FlowStartResult, data=input.model_dump(exclude_none=True))
 
         async def update(
-            self, flow_id: str, choice: m.FlowChoice, data: m.FlowUpdateData = {}
+            self,
+            flow_id: str,
+            choice: m.FlowChoice,
+            data: m.FlowUpdateData = {},  # noqa: B006
         ) -> PangeaResponse[m.FlowUpdateResult]:
             """
             Update a sign-up/sign-in flow
@@ -1086,7 +1094,7 @@ class AuthNAsync(ServiceBaseAsync):
                 A PangeaResponse with information about next steps needed
                     to complete a flow in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/update).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/flow#/v2/flow/update-post).
 
             Examples:
                 response = authn.flow.update(
@@ -1133,7 +1141,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a EULA object in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/create).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/create-post).
 
             Examples:
                 response = authn.agreements.create(
@@ -1200,7 +1208,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with a list of EULA objects in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/list).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/list-post).
 
             Examples:
                 response = authn.agreements.list()
@@ -1238,7 +1246,7 @@ class AuthNAsync(ServiceBaseAsync):
             Returns:
                 A PangeaResponse with the updated EULA object in the response.result field.
                     Available response fields can be found in our
-                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/update).
+                    [API Documentation](https://pangea.cloud/docs/api/authn/agreements#/v2/agreements/update-post).
 
             Examples:
                 response = authn.agreements.update(