Release v0.13.0

Origin-SHA: 88bfe14ab42a420816c35f1a097feb0f046d77bd

### Minor Changes

- 7d51b1f: Sync OpenAPI spec.

  - Adds the drop publish flow operations: `build_drop_publish_transaction`, `build_drop_unpublish_transaction`, `upload_drop_metadata_to_ipfs`, `get_drop_metadata_ipfs_progress` and `upload_drop_collection_manifest`, with the `DropTransactionResponse`, `DropMetadataUploadResponse` and `DropMetadataUploadProgressResponse` schemas, and adds their routes to the `write:drops` scope.
  - `SelfMintDropItemResponse` now carries the transaction fields plus `token_id`.
  - Fields the API documents as nullable are now typed nullable: the spec is OpenAPI 3.1 and os2-core now emits `type: [T, "null"]` or `anyOf: [ref, null]` for them. Code that reads these fields may need a null check. This is why the bump is minor.
  - `label` is now required on drop stage edits (`SaveDropEditsStageRequest`). A stage without one was accepted before but could never be published.
  - The shared 400/403/404/409 responses document the `V1ErrorWrapper` body, `NftSearchResponse` gains the optional `best_listing` field, and field descriptions are updated.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: ryanio

CHANGELOG.md

@@ -1,5 +1,17 @@
 # @opensea/api-types
 
+## 0.13.0
+
+### Minor Changes
+
+- 7d51b1f: Sync OpenAPI spec.
+
+  - Adds the drop publish flow operations: `build_drop_publish_transaction`, `build_drop_unpublish_transaction`, `upload_drop_metadata_to_ipfs`, `get_drop_metadata_ipfs_progress` and `upload_drop_collection_manifest`, with the `DropTransactionResponse`, `DropMetadataUploadResponse` and `DropMetadataUploadProgressResponse` schemas, and adds their routes to the `write:drops` scope.
+  - `SelfMintDropItemResponse` now carries the transaction fields plus `token_id`.
+  - Fields the API documents as nullable are now typed nullable: the spec is OpenAPI 3.1 and os2-core now emits `type: [T, "null"]` or `anyOf: [ref, null]` for them. Code that reads these fields may need a null check. This is why the bump is minor.
+  - `label` is now required on drop stage edits (`SaveDropEditsStageRequest`). A stage without one was accepted before but could never be published.
+  - The shared 400/403/404/409 responses document the `V1ErrorWrapper` body, `NftSearchResponse` gains the optional `best_listing` field, and field descriptions are updated.
+
 ## 0.12.1
 
 ### Patch Changes

opensea-api.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensea/api-types",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Auto-generated TypeScript types from the OpenSea API OpenAPI spec",
   "license": "MIT",
   "author": "OpenSea Developers",

package-lock.json

@@ -87,7 +87,7 @@ export const AUTH_SCOPES = [
     displayName: "Creator Studio drop management",
     description: "Manage Creator Studio drops for authenticated account",
     group: "write",
-    endpoints: ["/api/v2/drops/{slug}","/api/v2/drops/{slug}/allowlist","/api/v2/drops/{slug}/allowlist/validate","/api/v2/drops/{slug}/prereveal-item","/api/v2/drops/{slug}/items","/api/v2/drops/{slug}/items/media","/api/v2/drops/{slug}/items/media/save","/api/v2/drops/{slug}/items/{token_id}"],
+    endpoints: ["/api/v2/drops/{slug}","/api/v2/drops/{slug}/allowlist","/api/v2/drops/{slug}/allowlist/validate","/api/v2/drops/{slug}/prereveal-item","/api/v2/drops/{slug}/items","/api/v2/drops/{slug}/items/media","/api/v2/drops/{slug}/items/media/save","/api/v2/drops/{slug}/items/manifest","/api/v2/drops/{slug}/items/{token_id}","/api/v2/drops/{slug}/metadata/ipfs","/api/v2/drops/{slug}/metadata/ipfs/{workflow_execution_id}","/api/v2/drops/{slug}/publish","/api/v2/drops/{slug}/unpublish"],
     mcpTools: ["manage_drops"],
   },
   {

package.json

@@ -815,6 +815,24 @@ export type DropItemAttributeResponse = Schemas["DropItemAttributeResponse"]
  */
 export type DropItemResponse = Schemas["DropItemResponse"]
 
+/**
+ * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
+ * camelizes responses and snakeizes request bodies, so annotate an
+ * SDK-facing value with `Camelize<DropMetadataUploadProgressResponse>` (exported by
+ * `@opensea/sdk`) or the matching `@opensea/sdk` type rather than with
+ * `DropMetadataUploadProgressResponse`.
+ */
+export type DropMetadataUploadProgressResponse = Schemas["DropMetadataUploadProgressResponse"]
+
+/**
+ * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
+ * camelizes responses and snakeizes request bodies, so annotate an
+ * SDK-facing value with `Camelize<DropMetadataUploadResponse>` (exported by
+ * `@opensea/sdk`) or the matching `@opensea/sdk` type rather than with
+ * `DropMetadataUploadResponse`.
+ */
+export type DropMetadataUploadResponse = Schemas["DropMetadataUploadResponse"]
+
 /**
  * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
  * camelizes responses and snakeizes request bodies, so annotate an
@@ -869,6 +887,15 @@ export type DropStageEligibilityResponse = Schemas["DropStageEligibilityResponse
  */
 export type DropStageResponse = Schemas["DropStageResponse"]
 
+/**
+ * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
+ * camelizes responses and snakeizes request bodies, so annotate an
+ * SDK-facing value with `Camelize<DropTransactionResponse>` (exported by
+ * `@opensea/sdk`) or the matching `@opensea/sdk` type rather than with
+ * `DropTransactionResponse`.
+ */
+export type DropTransactionResponse = Schemas["DropTransactionResponse"]
+
 /**
  * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
  * camelizes responses and snakeizes request bodies, so annotate an
@@ -1364,6 +1391,15 @@ export type NftResponse = Schemas["NftResponse"]
  */
 export type NftSalePointResponse = Schemas["NftSalePointResponse"]
 
+/**
+ * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
+ * camelizes responses and snakeizes request bodies, so annotate an
+ * SDK-facing value with `Camelize<NftSearchBestListingResponse>` (exported by
+ * `@opensea/sdk`) or the matching `@opensea/sdk` type rather than with
+ * `NftSearchBestListingResponse`.
+ */
+export type NftSearchBestListingResponse = Schemas["NftSearchBestListingResponse"]
+
 /**
  * Wire shape, snake_case as the API sends and accepts it. `@opensea/sdk`
  * camelizes responses and snakeizes request bodies, so annotate an