@vrplatform/api 1.3.1-stage.4584 → 1.3.1-stage.4597

package/build/main/generated/v1.d.ts

@@ -3800,7 +3800,7 @@ export interface paths {
         get: operations["getStatements"];
         put?: never;
         /**
-         * @description Create an owner statement for an ownership period and month. Freezes the statement layout, and creating with a finalized status (inReview or published) attaches the period journal entries to the statement, locking them against further changes. Statements with blocking issues cannot be created in a non-draft status, and publishing out of month order is rejected. Supports dryRun. See https://docs.vrplatform.app/guides/build/statements.
+         * @description Create an owner statement for an ownership period and month. Freezes the statement layout, and creating with a finalized status (inReview or published) attaches the period journal entries to the statement, locking them against further changes. Statements with blocking issues cannot be created in a non-draft status, and publishing out of month order is rejected. Exactly one listingPeriodIds entry is required. Re-creating an existing statement regenerates it, but a published statement can never be moved away from published this way — that returns 409; use the update endpoint for status transitions. Supports dryRun. See https://docs.vrplatform.app/guides/build/statements.
          *
          *     Required scope: statements:write
          */
@@ -4106,7 +4106,7 @@ export interface paths {
          */
         get: operations["getStatementsById"];
         /**
-         * @description Update an owner statement status (draft, inReview, published). Moving to a finalized status attaches the period journal entries to the statement and locks writes that reference the same ownership period; moving back to draft detaches them again. Transitions are rejected when the statement has blocking issues, when a later statement for the period is already finalized, or when a prior month is still unfinalized. Publishing can optionally email owners via emailDelivery. Supports dryRun. See https://docs.vrplatform.app/guides/build/statements#status-transitions.
+         * @description Update an owner statement status (draft, inReview, published). Moving to a finalized status attaches the period journal entries to the statement and locks writes that reference the same ownership period; moving back to draft detaches them again. Transitions are rejected when the statement has blocking issues, when a later statement for the period is already finalized, or when a prior month is still unfinalized. For scoped API credentials, both publishing and moving a published statement away from published require the statements:publish scope. Publishing can optionally email owners via emailDelivery. Supports dryRun. See https://docs.vrplatform.app/guides/build/statements#status-transitions.
          *
          *     Required scope: statements:write
          */
@@ -4548,7 +4548,7 @@ export interface paths {
         get: operations["getTeams"];
         put?: never;
         /**
-         * @description Create team
+         * @description Create team. Partner provisioning requires a uniqueRef; if a team with that uniqueRef already exists for the partner the request fails with 409 — fetch the existing team with GET /teams/lookup. Retrying a provisioning request that failed before completing is safe.
          *
          *     Required scope: teams:provision
          */