> ## Documentation Index > Fetch the complete documentation index at: https://docs.vibechain.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a complete metadata draft > Creates a launch draft containing at least four card metadata items. The `creator` wallet must belong to the signed-in account. Use the poll endpoint instead when building an autosave workflow. ## OpenAPI ````yaml /api-reference/vibemarket_openapi.yml post /metadata/draft openapi: 3.0.3 info: title: vibe.market API version: 1.0.0 description: | Production API for vibe.market packs, games, collections, creator drafts, allowlists, market activity, social features, recovery tools, and analytics. Most operations require a caller-specific VibeChain API key in the `API-KEY` header. Account-bound writes additionally require a vibe.market session token in `Authorization: Bearer `. Public or Bearer-only exceptions are marked on the individual operation. contact: name: VibeChain developer support email: gm@vibechain.com url: https://docs.vibechain.com/api-reference/vibemarket-intro servers: - url: https://build.vibechain.com/vibe/boosterbox description: Production security: - ApiKeyAuth: [] tags: - name: Packs description: Read pack ownership, state, rarity, and metadata. - name: Collections description: Read collection holdings, statistics, and activity. - name: Games description: Discover games and read launch configuration. - name: Metadata description: Read published metadata and update launched collections. - name: Creator drafts description: Create, autosave, inspect, confirm, and delete launch drafts. - name: Allowlists description: Configure draft allowlists and generate Merkle proofs. - name: Activity description: Read recent packs and recover indexed transaction events. - name: Social description: Read chat, react to messages, and report collections. - name: Analytics description: Read price history, leaderboards, and platform totals. - name: Utility description: Resolve slugs, regions, prices, and processing readiness. paths: /metadata/draft: post: tags: - Creator drafts summary: Create a complete metadata draft description: | Creates a launch draft containing at least four card metadata items. The `creator` wallet must belong to the signed-in account. Use the poll endpoint instead when building an autosave workflow. operationId: createVibeMarketMetadataDraft requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateDraftRequest' responses: '200': description: Draft created content: application/json: schema: $ref: '#/components/schemas/CreateDraftResponse' '400': $ref: '#/components/responses/InvalidInput' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/ApiKeyOrRateLimit' '500': $ref: '#/components/responses/InternalError' security: - ApiKeyAuth: [] BearerAuth: [] components: schemas: CreateDraftRequest: allOf: - $ref: '#/components/schemas/DraftCollectionFields' - type: object required: - creator - metadataItems properties: creator: $ref: '#/components/schemas/EvmAddress' metadataItems: type: array minItems: 4 items: $ref: '#/components/schemas/MetadataItemInput' txHash: $ref: '#/components/schemas/TransactionHash' CreateDraftResponse: type: object required: - success - message - draftId - drafts - draftGame properties: success: type: boolean enum: - true message: type: string draftId: $ref: '#/components/schemas/ObjectId' drafts: type: array items: $ref: '#/components/schemas/DraftCardSummary' draftGame: $ref: '#/components/schemas/DraftGame' DraftCollectionFields: type: object properties: bgColor: type: string slug: type: string featuredImageUrl: type: string format: uri disableFoil: type: boolean default: false disableWear: type: boolean default: false twitterLink: type: string format: uri websiteLink: type: string format: uri description: type: string isNSFW: type: boolean default: false EvmAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0x1111111111111111111111111111111111111111' MetadataItemInput: type: object required: - name - imageUrl - rarity properties: name: type: string minLength: 1 imageUrl: type: string format: uri unopenedImageUrl: type: string format: uri firstEditionImageUrl: type: string format: uri description: type: string rarity: $ref: '#/components/schemas/CardRarity' externalLink: type: string format: uri privateExternalLink: type: string format: uri metadataDescription: type: string traits: type: array maxItems: 20 items: $ref: '#/components/schemas/Trait' startId: type: integer minimum: 0 endId: type: integer minimum: 0 TransactionHash: type: string pattern: ^0x[a-fA-F0-9]{64}$ example: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' ObjectId: type: string pattern: ^[a-fA-F0-9]{24}$ example: 66b1234567890abcdef12345 DraftCardSummary: type: object required: - id - name - rarity - imageUrl properties: id: type: string name: type: string rarity: $ref: '#/components/schemas/CardRarity' imageUrl: type: string format: uri txHash: $ref: '#/components/schemas/TransactionHash' DraftGame: type: object additionalProperties: true properties: id: $ref: '#/components/schemas/ObjectId' _id: $ref: '#/components/schemas/ObjectId' txHash: $ref: '#/components/schemas/TransactionHash' slug: type: string nftName: type: string tokenSymbol: type: string bgColor: type: string featuredImageUrl: type: string format: uri packImageUrl: type: string format: uri links: $ref: '#/components/schemas/LinkSet' description: type: string isNSFW: type: boolean isPublic: type: boolean ownerAddress: $ref: '#/components/schemas/EvmAddress' disableWear: type: boolean disableFoil: type: boolean metadataItems: type: array items: $ref: '#/components/schemas/MetadataItem' Error: type: object required: - success - message properties: success: type: boolean enum: - false message: type: string error: description: >- Optional diagnostic detail. Do not depend on this field being present in production. oneOf: - type: string - type: object additionalProperties: true CardRarity: type: string enum: - Common - Rare - Epic - Legendary - Mythic Trait: type: object required: - key - value properties: key: type: string maxLength: 100 value: type: string maxLength: 100 LinkSet: type: object properties: twitter: type: string format: uri website: type: string format: uri MetadataItem: allOf: - $ref: '#/components/schemas/MetadataItemInput' - type: object additionalProperties: true properties: id: type: string contractAddress: $ref: '#/components/schemas/EvmAddress' chainId: type: integer txHash: $ref: '#/components/schemas/TransactionHash' creator: $ref: '#/components/schemas/EvmAddress' metadataSource: type: string enum: - user - default isActive: type: boolean isDraft: type: boolean version: type: integer effectiveFrom: type: string format: date-time effectiveUntil: type: string format: date-time nullable: true bgColor: type: string slug: type: string featuredImageUrl: type: string format: uri disableFoil: type: boolean disableWear: type: boolean odds: type: number format: double oddsFormatted: type: string wear: $ref: '#/components/schemas/Wear' foil: $ref: '#/components/schemas/Foil' Wear: type: string enum: - Pristine - Mint - Lightly Played - Moderately Played - Heavily Played Foil: type: string enum: - None - Standard - Prize - Any Foil responses: InvalidInput: description: Invalid or incomplete request input content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Invalid contract address Unauthorized: description: Bearer token missing, expired, or invalid content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Unauthorized - No token provided ApiKeyOrRateLimit: description: API key missing/invalid or the caller's rate allowance is exhausted content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: >- Too many requests or invalid API key! See docs.vibechain.com for more info. InternalError: description: The server could not complete the operation content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Failed to complete request securitySchemes: ApiKeyAuth: type: apiKey in: header name: API-KEY description: Caller-specific VibeChain API key used for quota and abuse control. BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Signed-in vibe.market session token. The account's linked wallets determine creator ownership. ````