fix(docs): add @throws to PHPDoc when appropriate

.oagen-manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "language": "php",
-  "generatedAt": "2026-04-14T19:04:38.043Z",
+  "generatedAt": "2026-04-14T19:47:26.865Z",
   "files": [
     "lib/Resource/ActionAuthenticationDenied.php",
     "lib/Resource/ActionAuthenticationDeniedData.php",

lib/Service/AdminPortal.php

@@ -34,6 +34,7 @@ public function __construct(
      * @param \WorkOS\Resource\IntentOptions|null $intentOptions Options to configure the Admin Portal based on the intent.
      * @param array<string>|null $adminEmails The email addresses of the IT admins to grant access to the Admin Portal for the given organization. Accepts up to 20 emails.
      * @return \WorkOS\Resource\PortalLinkResponse
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function generateLink(
         string $organization,

lib/Service/ApiKeys.php

@@ -23,6 +23,7 @@ public function __construct(
      * Validate an API key value and return the API key object if valid.
      * @param string $value The value for an API key.
      * @return \WorkOS\Resource\ApiKeyValidationResponse
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function createValidation(
         string $value,
@@ -46,6 +47,7 @@ public function createValidation(
      * Permanently deletes an API key. This action cannot be undone. Once deleted, any requests using this API key will fail authentication.
      * @param string $id The unique ID of the API key.
      * @return void
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function deleteApiKey(
         string $id,
@@ -68,6 +70,7 @@ public function deleteApiKey(
      * @param int|null $limit Upper limit on the number of objects to return, between `1` and `100`. Defaults to 10.
      * @param \WorkOS\Resource\EventsOrder|null $order Order the results by the creation time. Defaults to "desc".
      * @return \WorkOS\PaginatedResponse<\WorkOS\Resource\ApiKey>
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function listOrganizationApiKeys(
         string $organizationId,
@@ -100,6 +103,7 @@ public function listOrganizationApiKeys(
      * @param string $name The name for the API key.
      * @param array<string>|null $permissions The permission slugs to assign to the API key.
      * @return \WorkOS\Resource\ApiKeyWithValue
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function createOrganizationApiKey(
         string $organizationId,

lib/Service/AuditLogs.php

@@ -25,6 +25,7 @@ public function __construct(
      * Get the configured event retention period for the given Organization.
      * @param string $id Unique identifier of the Organization.
      * @return \WorkOS\Resource\AuditLogsRetentionJson
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function getOrganizationAuditLogsRetention(
         string $id,
@@ -45,6 +46,7 @@ public function getOrganizationAuditLogsRetention(
      * @param string $id Unique identifier of the Organization.
      * @param int $retentionPeriodInDays The number of days Audit Log events will be retained. Valid values are `30` and `365`.
      * @return \WorkOS\Resource\AuditLogsRetentionJson
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function updateOrganizationAuditLogsRetention(
         string $id,
@@ -72,6 +74,7 @@ public function updateOrganizationAuditLogsRetention(
      * @param int|null $limit Upper limit on the number of objects to return, between `1` and `100`. Defaults to 10.
      * @param \WorkOS\Resource\EventsOrder|null $order Order the results by the creation time. Defaults to "desc".
      * @return \WorkOS\PaginatedResponse<\WorkOS\Resource\AuditLogActionJson>
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function listActions(
         ?string $before = null,
@@ -105,6 +108,7 @@ public function listActions(
      * @param int|null $limit Upper limit on the number of objects to return, between `1` and `100`. Defaults to 10.
      * @param \WorkOS\Resource\EventsOrder|null $order Order the results by the creation time. Defaults to "desc".
      * @return \WorkOS\PaginatedResponse<\WorkOS\Resource\AuditLogSchemaJson>
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function listActionSchemas(
         string $actionName,
@@ -138,6 +142,7 @@ public function listActionSchemas(
      * @param array<\WorkOS\Resource\AuditLogSchemaTarget> $targets The list of targets for the schema.
      * @param array<string, mixed>|null $metadata Optional JSON schema for event metadata.
      * @return \WorkOS\Resource\AuditLogSchemaJson
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function createSchema(
         string $actionName,
@@ -173,6 +178,7 @@ public function createSchema(
      * @param string $organizationId The unique ID of the Organization.
      * @param \WorkOS\Resource\AuditLogEvent $event The audit log event to create.
      * @return \WorkOS\Resource\AuditLogEventCreateResponse
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function createEvent(
         string $organizationId,
@@ -205,6 +211,7 @@ public function createEvent(
      * @param array<string>|null $actorIds List of actor IDs to filter against.
      * @param array<string>|null $targets List of target types to filter against.
      * @return \WorkOS\Resource\AuditLogExportJson
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function createExport(
         string $organizationId,
@@ -242,6 +249,7 @@ public function createExport(
      * Get an Audit Log Export. The URL will expire after 10 minutes. If the export is needed again at a later time, refetching the export will regenerate the URL.
      * @param string $auditLogExportId The unique ID of the Audit Log Export.
      * @return \WorkOS\Resource\AuditLogExportJson
+     * @throws \WorkOS\Exception\WorkOSException
      */
     public function getExport(
         string $auditLogExportId,