Skip to content

Commit 56b8ae2

Browse files
stainless-app[bot]stainless-app[bot]
committed
chore(api): update composite API spec
1 parent 409955f commit 56b8ae2

6 files changed

Lines changed: 83 additions & 16 deletions

File tree

‎.stats.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 2418
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-d243a405486a776fde567c6cd063083f78866d97bafc66c621e311c4ec37faa8.yml
3-
openapi_spec_hash: 5bdca7468c199405ddfa3209f852762b
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-bd56ab70f18eeddb377203f0766f19e3c4d91162e1782a20848e579729778608.yml
3+
openapi_spec_hash: 75ded8f4018def0946f2b3e23ca4b929
44
config_hash: cd80863b2a094f3805409e4a5676b0b8

‎src/cloudflare/resources/iam/sso.py‎

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,8 @@ def create(
6565
timeout: float | httpx.Timeout | None | NotGiven = not_given,
6666
) -> Optional[SSOCreateResponse]:
6767
"""
68-
Initialize new SSO connector
68+
Creates a new SSO connector for logging into Cloudflare through an identity
69+
provider.
6970
7071
Args:
7172
account_id: Account identifier tag.
@@ -121,7 +122,7 @@ def update(
121122
timeout: float | httpx.Timeout | None | NotGiven = not_given,
122123
) -> Optional[SSOUpdateResponse]:
123124
"""
124-
Update SSO connector state
125+
Updates the state or configuration of an SSO connector.
125126
126127
Args:
127128
account_id: Account identifier tag.
@@ -179,7 +180,7 @@ def list(
179180
timeout: float | httpx.Timeout | None | NotGiven = not_given,
180181
) -> SyncSinglePage[SSOListResponse]:
181182
"""
182-
Get all SSO connectors
183+
Lists all SSO connectors configured for the account.
183184
184185
Args:
185186
account_id: Account identifier tag.
@@ -216,7 +217,7 @@ def delete(
216217
timeout: float | httpx.Timeout | None | NotGiven = not_given,
217218
) -> Optional[SSODeleteResponse]:
218219
"""
219-
Delete SSO connector
220+
Deletes an SSO connector from the account.
220221
221222
Args:
222223
account_id: Account identifier tag.
@@ -264,7 +265,8 @@ def begin_verification(
264265
timeout: float | httpx.Timeout | None | NotGiven = not_given,
265266
) -> SSOBeginVerificationResponse:
266267
"""
267-
Begin SSO connector verification
268+
Validates the user has added the DNS TXT record required for validating
269+
ownership of the domain they are trying to set up a connector for.
268270
269271
Args:
270272
account_id: Account identifier tag.
@@ -308,7 +310,7 @@ def get(
308310
timeout: float | httpx.Timeout | None | NotGiven = not_given,
309311
) -> Optional[SSOGetResponse]:
310312
"""
311-
Get single SSO connector
313+
Retrieves details for a specific SSO connector.
312314
313315
Args:
314316
account_id: Account identifier tag.
@@ -379,7 +381,8 @@ async def create(
379381
timeout: float | httpx.Timeout | None | NotGiven = not_given,
380382
) -> Optional[SSOCreateResponse]:
381383
"""
382-
Initialize new SSO connector
384+
Creates a new SSO connector for logging into Cloudflare through an identity
385+
provider.
383386
384387
Args:
385388
account_id: Account identifier tag.
@@ -435,7 +438,7 @@ async def update(
435438
timeout: float | httpx.Timeout | None | NotGiven = not_given,
436439
) -> Optional[SSOUpdateResponse]:
437440
"""
438-
Update SSO connector state
441+
Updates the state or configuration of an SSO connector.
439442
440443
Args:
441444
account_id: Account identifier tag.
@@ -493,7 +496,7 @@ def list(
493496
timeout: float | httpx.Timeout | None | NotGiven = not_given,
494497
) -> AsyncPaginator[SSOListResponse, AsyncSinglePage[SSOListResponse]]:
495498
"""
496-
Get all SSO connectors
499+
Lists all SSO connectors configured for the account.
497500
498501
Args:
499502
account_id: Account identifier tag.
@@ -530,7 +533,7 @@ async def delete(
530533
timeout: float | httpx.Timeout | None | NotGiven = not_given,
531534
) -> Optional[SSODeleteResponse]:
532535
"""
533-
Delete SSO connector
536+
Deletes an SSO connector from the account.
534537
535538
Args:
536539
account_id: Account identifier tag.
@@ -578,7 +581,8 @@ async def begin_verification(
578581
timeout: float | httpx.Timeout | None | NotGiven = not_given,
579582
) -> SSOBeginVerificationResponse:
580583
"""
581-
Begin SSO connector verification
584+
Validates the user has added the DNS TXT record required for validating
585+
ownership of the domain they are trying to set up a connector for.
582586
583587
Args:
584588
account_id: Account identifier tag.
@@ -622,7 +626,7 @@ async def get(
622626
timeout: float | httpx.Timeout | None | NotGiven = not_given,
623627
) -> Optional[SSOGetResponse]:
624628
"""
625-
Get single SSO connector
629+
Retrieves details for a specific SSO connector.
626630
627631
Args:
628632
account_id: Account identifier tag.

‎src/cloudflare/resources/user/user.py‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -198,7 +198,10 @@ def get(
198198
extra_body: Body | None = None,
199199
timeout: float | httpx.Timeout | None | NotGiven = not_given,
200200
) -> Optional[UserGetResponse]:
201-
"""User Details"""
201+
"""
202+
Retrieves detailed information about the currently authenticated user, including
203+
email, name, and account memberships.
204+
"""
202205
return self._get(
203206
"/user",
204207
options=make_request_options(
@@ -329,7 +332,10 @@ async def get(
329332
extra_body: Body | None = None,
330333
timeout: float | httpx.Timeout | None | NotGiven = not_given,
331334
) -> Optional[UserGetResponse]:
332-
"""User Details"""
335+
"""
336+
Retrieves detailed information about the currently authenticated user, including
337+
email, name, and account memberships.
338+
"""
333339
return await self._get(
334340
"/user",
335341
options=make_request_options(

‎src/cloudflare/types/accounts/tokens/permission_group_get_response.py‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,25 @@ class PermissionGroupGetResponseItem(BaseModel):
1212
id: Optional[str] = None
1313
"""Public ID."""
1414

15+
category: Optional[
16+
Literal[
17+
"developer_platform",
18+
"ai_and_machine_learning",
19+
"dns_and_zones",
20+
"app_security",
21+
"rules_and_configuration",
22+
"cloudflare_one_and_zero_trust",
23+
"analytics_and_logs",
24+
"network_services",
25+
"media",
26+
"email_and_messaging",
27+
"cache_and_performance",
28+
"account_and_billing",
29+
"other",
30+
]
31+
] = None
32+
"""Product category that this permission group belongs to."""
33+
1534
name: Optional[str] = None
1635
"""Permission Group Name"""
1736

‎src/cloudflare/types/accounts/tokens/permission_group_list_response.py‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,25 @@ class PermissionGroupListResponse(BaseModel):
1212
id: Optional[str] = None
1313
"""Public ID."""
1414

15+
category: Optional[
16+
Literal[
17+
"developer_platform",
18+
"ai_and_machine_learning",
19+
"dns_and_zones",
20+
"app_security",
21+
"rules_and_configuration",
22+
"cloudflare_one_and_zero_trust",
23+
"analytics_and_logs",
24+
"network_services",
25+
"media",
26+
"email_and_messaging",
27+
"cache_and_performance",
28+
"account_and_billing",
29+
"other",
30+
]
31+
] = None
32+
"""Product category that this permission group belongs to."""
33+
1534
name: Optional[str] = None
1635
"""Permission Group Name"""
1736

‎src/cloudflare/types/user/tokens/permission_group_list_response.py‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,25 @@ class PermissionGroupListResponse(BaseModel):
1212
id: Optional[str] = None
1313
"""Public ID."""
1414

15+
category: Optional[
16+
Literal[
17+
"developer_platform",
18+
"ai_and_machine_learning",
19+
"dns_and_zones",
20+
"app_security",
21+
"rules_and_configuration",
22+
"cloudflare_one_and_zero_trust",
23+
"analytics_and_logs",
24+
"network_services",
25+
"media",
26+
"email_and_messaging",
27+
"cache_and_performance",
28+
"account_and_billing",
29+
"other",
30+
]
31+
] = None
32+
"""Product category that this permission group belongs to."""
33+
1534
name: Optional[str] = None
1635
"""Permission Group Name"""
1736

0 commit comments

Comments
 (0)