@workos/openapi-spec 0.22.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,36 +13,56 @@ paths:
13
13
  content:
14
14
  application/json:
15
15
  schema:
16
- type: object
17
- properties:
18
- type:
19
- type: string
20
- enum:
21
- - api_key
22
- - access_token
23
- description: >-
24
- The kind of credential being validated — an agent API key or
25
- an agent access token.
26
- example: access_token
27
- credential:
28
- type: string
29
- minLength: 1
30
- description: >-
31
- The credential value to validate: the API key value for
32
- `api_key`, or the access token (JWT) for `access_token`.
33
- example: sk_agent_example_1234567890
34
- audience:
35
- type: string
36
- minLength: 1
37
- description: >-
38
- Only applies to `access_token` credentials. When provided,
39
- the access token's `aud` claim is verified against this
40
- value — tokens issued for a different resource are rejected.
41
- Not permitted for `api_key` credentials.
42
- example: https://api.example.com
43
- required:
44
- - type
45
- - credential
16
+ discriminator:
17
+ propertyName: type
18
+ oneOf:
19
+ - type: object
20
+ properties:
21
+ type:
22
+ type: string
23
+ description: >-
24
+ The kind of credential being validated — an agent API
25
+ key or an agent access token.
26
+ const: api_key
27
+ credential:
28
+ type: string
29
+ minLength: 1
30
+ description: >-
31
+ The credential value to validate: the API key value for
32
+ `api_key`, or the access token (JWT) for `access_token`.
33
+ example: sk_agent_example_1234567890
34
+ required:
35
+ - type
36
+ - credential
37
+ - type: object
38
+ properties:
39
+ type:
40
+ type: string
41
+ description: >-
42
+ The kind of credential being validated — an agent API
43
+ key or an agent access token.
44
+ const: access_token
45
+ credential:
46
+ type: string
47
+ minLength: 1
48
+ description: >-
49
+ The credential value to validate: the API key value for
50
+ `api_key`, or the access token (JWT) for `access_token`.
51
+ example: eyJhbGciOiJSUzI1NiIsImtpZCI6...
52
+ audience:
53
+ type: string
54
+ minLength: 1
55
+ description: >-
56
+ When provided, the access token's `aud` claim is
57
+ verified against this value. Tokens issued for a
58
+ different resource are rejected.
59
+ example: https://api.example.com
60
+ required:
61
+ - type
62
+ - credential
63
+ description: >-
64
+ The agent credential to validate. Either an `api_key` or an
65
+ `access_token`, discriminated by `type`.
46
66
  responses:
47
67
  '200':
48
68
  description: OK
@@ -21536,6 +21556,7 @@ components:
21536
21556
  - agent.registration.claim.attempt.created
21537
21557
  - agent.registration.claim.completed
21538
21558
  - agent.registration.credential.issued
21559
+ - agent.registration.expired
21539
21560
  - agent.registration.organization.switched
21540
21561
  - authentication.email_verification_succeeded
21541
21562
  - authentication.magic_auth_failed
@@ -25601,6 +25622,42 @@ components:
25601
25622
  - data
25602
25623
  - created_at
25603
25624
  - object
25625
+ - type: object
25626
+ properties:
25627
+ id:
25628
+ type: string
25629
+ description: Unique identifier for the event.
25630
+ example: event_01EHZNVPK3SFK441A1RGBFSHRT
25631
+ event:
25632
+ type: string
25633
+ const: agent.registration.expired
25634
+ data:
25635
+ type: object
25636
+ properties:
25637
+ agent_registration_id:
25638
+ type: string
25639
+ description: The agent registration that expired.
25640
+ example: agent_reg_01EHWNCE74X7JSDV0X3SZ3KJNY
25641
+ required:
25642
+ - agent_registration_id
25643
+ description: The event payload.
25644
+ created_at:
25645
+ format: date-time
25646
+ type: string
25647
+ description: An ISO 8601 timestamp.
25648
+ example: '2026-01-15T12:00:00.000Z'
25649
+ context:
25650
+ $ref: '#/components/schemas/EventContextDto'
25651
+ object:
25652
+ type: string
25653
+ description: Distinguishes the Event object.
25654
+ const: event
25655
+ required:
25656
+ - id
25657
+ - event
25658
+ - data
25659
+ - created_at
25660
+ - object
25604
25661
  - type: object
25605
25662
  properties:
25606
25663
  id:
package/dist/types.d.ts CHANGED
@@ -4787,7 +4787,7 @@ export interface components {
4787
4787
  * "dsync.user.created"
4788
4788
  * ]
4789
4789
  */
4790
- events: ("agent.registration.created" | "agent.registration.claim.attempt.created" | "agent.registration.claim.completed" | "agent.registration.credential.issued" | "agent.registration.organization.switched" | "authentication.email_verification_succeeded" | "authentication.magic_auth_failed" | "authentication.magic_auth_succeeded" | "authentication.mfa_succeeded" | "authentication.oauth_failed" | "authentication.oauth_succeeded" | "authentication.password_failed" | "authentication.password_succeeded" | "authentication.passkey_failed" | "authentication.passkey_succeeded" | "authentication.sso_failed" | "authentication.sso_started" | "authentication.sso_succeeded" | "authentication.sso_timed_out" | "authentication.radar_risk_detected" | "authentication.reauthentication_succeeded" | "api_key.created" | "api_key.revoked" | "api_key.updated" | "connection.activated" | "connection.deactivated" | "connection.saml_certificate_renewal_required" | "connection.saml_certificate_renewed" | "connection.deleted" | "dsync.activated" | "dsync.deleted" | "dsync.group.created" | "dsync.group.deleted" | "dsync.group.updated" | "dsync.group.user_added" | "dsync.group.user_removed" | "dsync.user.created" | "dsync.user.deleted" | "dsync.user.updated" | "email_verification.created" | "group.created" | "group.deleted" | "group.member_added" | "group.member_removed" | "group.updated" | "flag.created" | "flag.deleted" | "flag.updated" | "flag.rule_updated" | "invitation.accepted" | "invitation.created" | "invitation.resent" | "invitation.revoked" | "magic_auth.created" | "organization.created" | "organization.deleted" | "organization.updated" | "organization_domain.created" | "organization_domain.deleted" | "organization_domain.updated" | "organization_domain.verified" | "organization_domain.verification_failed" | "password_reset.created" | "password_reset.succeeded" | "user.created" | "user.updated" | "user.deleted" | "organization_membership.created" | "organization_membership.deleted" | "organization_membership.updated" | "role.created" | "role.deleted" | "role.updated" | "organization_role.created" | "organization_role.deleted" | "organization_role.updated" | "permission.created" | "permission.deleted" | "permission.updated" | "pipes.connected_account.connected" | "pipes.connected_account.connection_failed" | "pipes.connected_account.disconnected" | "pipes.connected_account.reauthorization_needed" | "session.created" | "session.revoked" | "waitlist_user.approved" | "waitlist_user.created" | "waitlist_user.denied")[];
4790
+ events: ("agent.registration.created" | "agent.registration.claim.attempt.created" | "agent.registration.claim.completed" | "agent.registration.credential.issued" | "agent.registration.expired" | "agent.registration.organization.switched" | "authentication.email_verification_succeeded" | "authentication.magic_auth_failed" | "authentication.magic_auth_succeeded" | "authentication.mfa_succeeded" | "authentication.oauth_failed" | "authentication.oauth_succeeded" | "authentication.password_failed" | "authentication.password_succeeded" | "authentication.passkey_failed" | "authentication.passkey_succeeded" | "authentication.sso_failed" | "authentication.sso_started" | "authentication.sso_succeeded" | "authentication.sso_timed_out" | "authentication.radar_risk_detected" | "authentication.reauthentication_succeeded" | "api_key.created" | "api_key.revoked" | "api_key.updated" | "connection.activated" | "connection.deactivated" | "connection.saml_certificate_renewal_required" | "connection.saml_certificate_renewed" | "connection.deleted" | "dsync.activated" | "dsync.deleted" | "dsync.group.created" | "dsync.group.deleted" | "dsync.group.updated" | "dsync.group.user_added" | "dsync.group.user_removed" | "dsync.user.created" | "dsync.user.deleted" | "dsync.user.updated" | "email_verification.created" | "group.created" | "group.deleted" | "group.member_added" | "group.member_removed" | "group.updated" | "flag.created" | "flag.deleted" | "flag.updated" | "flag.rule_updated" | "invitation.accepted" | "invitation.created" | "invitation.resent" | "invitation.revoked" | "magic_auth.created" | "organization.created" | "organization.deleted" | "organization.updated" | "organization_domain.created" | "organization_domain.deleted" | "organization_domain.updated" | "organization_domain.verified" | "organization_domain.verification_failed" | "password_reset.created" | "password_reset.succeeded" | "user.created" | "user.updated" | "user.deleted" | "organization_membership.created" | "organization_membership.deleted" | "organization_membership.updated" | "role.created" | "role.deleted" | "role.updated" | "organization_role.created" | "organization_role.deleted" | "organization_role.updated" | "permission.created" | "permission.deleted" | "permission.updated" | "pipes.connected_account.connected" | "pipes.connected_account.connection_failed" | "pipes.connected_account.disconnected" | "pipes.connected_account.reauthorization_needed" | "session.created" | "session.revoked" | "waitlist_user.approved" | "waitlist_user.created" | "waitlist_user.denied")[];
4791
4791
  };
4792
4792
  UpdateWebhookEndpointDto: {
4793
4793
  /**
@@ -4808,7 +4808,7 @@ export interface components {
4808
4808
  * "dsync.user.created"
4809
4809
  * ]
4810
4810
  */
4811
- events?: ("agent.registration.created" | "agent.registration.claim.attempt.created" | "agent.registration.claim.completed" | "agent.registration.credential.issued" | "agent.registration.organization.switched" | "authentication.email_verification_succeeded" | "authentication.magic_auth_failed" | "authentication.magic_auth_succeeded" | "authentication.mfa_succeeded" | "authentication.oauth_failed" | "authentication.oauth_succeeded" | "authentication.password_failed" | "authentication.password_succeeded" | "authentication.passkey_failed" | "authentication.passkey_succeeded" | "authentication.sso_failed" | "authentication.sso_started" | "authentication.sso_succeeded" | "authentication.sso_timed_out" | "authentication.radar_risk_detected" | "authentication.reauthentication_succeeded" | "api_key.created" | "api_key.revoked" | "api_key.updated" | "connection.activated" | "connection.deactivated" | "connection.saml_certificate_renewal_required" | "connection.saml_certificate_renewed" | "connection.deleted" | "dsync.activated" | "dsync.deleted" | "dsync.group.created" | "dsync.group.deleted" | "dsync.group.updated" | "dsync.group.user_added" | "dsync.group.user_removed" | "dsync.user.created" | "dsync.user.deleted" | "dsync.user.updated" | "email_verification.created" | "group.created" | "group.deleted" | "group.member_added" | "group.member_removed" | "group.updated" | "flag.created" | "flag.deleted" | "flag.updated" | "flag.rule_updated" | "invitation.accepted" | "invitation.created" | "invitation.resent" | "invitation.revoked" | "magic_auth.created" | "organization.created" | "organization.deleted" | "organization.updated" | "organization_domain.created" | "organization_domain.deleted" | "organization_domain.updated" | "organization_domain.verified" | "organization_domain.verification_failed" | "password_reset.created" | "password_reset.succeeded" | "user.created" | "user.updated" | "user.deleted" | "organization_membership.created" | "organization_membership.deleted" | "organization_membership.updated" | "role.created" | "role.deleted" | "role.updated" | "organization_role.created" | "organization_role.deleted" | "organization_role.updated" | "permission.created" | "permission.deleted" | "permission.updated" | "pipes.connected_account.connected" | "pipes.connected_account.connection_failed" | "pipes.connected_account.disconnected" | "pipes.connected_account.reauthorization_needed" | "session.created" | "session.revoked" | "waitlist_user.approved" | "waitlist_user.created" | "waitlist_user.denied")[];
4811
+ events?: ("agent.registration.created" | "agent.registration.claim.attempt.created" | "agent.registration.claim.completed" | "agent.registration.credential.issued" | "agent.registration.expired" | "agent.registration.organization.switched" | "authentication.email_verification_succeeded" | "authentication.magic_auth_failed" | "authentication.magic_auth_succeeded" | "authentication.mfa_succeeded" | "authentication.oauth_failed" | "authentication.oauth_succeeded" | "authentication.password_failed" | "authentication.password_succeeded" | "authentication.passkey_failed" | "authentication.passkey_succeeded" | "authentication.sso_failed" | "authentication.sso_started" | "authentication.sso_succeeded" | "authentication.sso_timed_out" | "authentication.radar_risk_detected" | "authentication.reauthentication_succeeded" | "api_key.created" | "api_key.revoked" | "api_key.updated" | "connection.activated" | "connection.deactivated" | "connection.saml_certificate_renewal_required" | "connection.saml_certificate_renewed" | "connection.deleted" | "dsync.activated" | "dsync.deleted" | "dsync.group.created" | "dsync.group.deleted" | "dsync.group.updated" | "dsync.group.user_added" | "dsync.group.user_removed" | "dsync.user.created" | "dsync.user.deleted" | "dsync.user.updated" | "email_verification.created" | "group.created" | "group.deleted" | "group.member_added" | "group.member_removed" | "group.updated" | "flag.created" | "flag.deleted" | "flag.updated" | "flag.rule_updated" | "invitation.accepted" | "invitation.created" | "invitation.resent" | "invitation.revoked" | "magic_auth.created" | "organization.created" | "organization.deleted" | "organization.updated" | "organization_domain.created" | "organization_domain.deleted" | "organization_domain.updated" | "organization_domain.verified" | "organization_domain.verification_failed" | "password_reset.created" | "password_reset.succeeded" | "user.created" | "user.updated" | "user.deleted" | "organization_membership.created" | "organization_membership.deleted" | "organization_membership.updated" | "role.created" | "role.deleted" | "role.updated" | "organization_role.created" | "organization_role.deleted" | "organization_role.updated" | "permission.created" | "permission.deleted" | "permission.updated" | "pipes.connected_account.connected" | "pipes.connected_account.connection_failed" | "pipes.connected_account.disconnected" | "pipes.connected_account.reauthorization_needed" | "session.created" | "session.revoked" | "waitlist_user.approved" | "waitlist_user.created" | "waitlist_user.denied")[];
4812
4812
  };
4813
4813
  WidgetSessionTokenDto: {
4814
4814
  /**
@@ -7938,6 +7938,34 @@ export interface components {
7938
7938
  * @constant
7939
7939
  */
7940
7940
  object: "event";
7941
+ } | {
7942
+ /**
7943
+ * @description Unique identifier for the event.
7944
+ * @example event_01EHZNVPK3SFK441A1RGBFSHRT
7945
+ */
7946
+ id: string;
7947
+ /** @constant */
7948
+ event: "agent.registration.expired";
7949
+ /** @description The event payload. */
7950
+ data: {
7951
+ /**
7952
+ * @description The agent registration that expired.
7953
+ * @example agent_reg_01EHWNCE74X7JSDV0X3SZ3KJNY
7954
+ */
7955
+ agent_registration_id: string;
7956
+ };
7957
+ /**
7958
+ * Format: date-time
7959
+ * @description An ISO 8601 timestamp.
7960
+ * @example 2026-01-15T12:00:00.000Z
7961
+ */
7962
+ created_at: string;
7963
+ context?: components["schemas"]["EventContextDto"];
7964
+ /**
7965
+ * @description Distinguishes the Event object.
7966
+ * @constant
7967
+ */
7968
+ object: "event";
7941
7969
  } | {
7942
7970
  /**
7943
7971
  * @description Unique identifier for the event.
@@ -16532,17 +16560,27 @@ export interface operations {
16532
16560
  "application/json": {
16533
16561
  /**
16534
16562
  * @description The kind of credential being validated — an agent API key or an agent access token.
16535
- * @example access_token
16536
- * @enum {string}
16563
+ * @constant
16537
16564
  */
16538
- type: "api_key" | "access_token";
16565
+ type: "api_key";
16539
16566
  /**
16540
16567
  * @description The credential value to validate: the API key value for `api_key`, or the access token (JWT) for `access_token`.
16541
16568
  * @example sk_agent_example_1234567890
16542
16569
  */
16543
16570
  credential: string;
16571
+ } | {
16572
+ /**
16573
+ * @description The kind of credential being validated — an agent API key or an agent access token.
16574
+ * @constant
16575
+ */
16576
+ type: "access_token";
16577
+ /**
16578
+ * @description The credential value to validate: the API key value for `api_key`, or the access token (JWT) for `access_token`.
16579
+ * @example eyJhbGciOiJSUzI1NiIsImtpZCI6...
16580
+ */
16581
+ credential: string;
16544
16582
  /**
16545
- * @description Only applies to `access_token` credentials. When provided, the access token's `aud` claim is verified against this value — tokens issued for a different resource are rejected. Not permitted for `api_key` credentials.
16583
+ * @description When provided, the access token's `aud` claim is verified against this value. Tokens issued for a different resource are rejected.
16546
16584
  * @example https://api.example.com
16547
16585
  */
16548
16586
  audience?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@workos/openapi-spec",
3
- "version": "0.22.0",
3
+ "version": "0.24.0",
4
4
  "type": "module",
5
5
  "description": "WorkOS OpenAPI specification, TypeScript types, and SDK resolution policy",
6
6
  "license": "MIT",