> ## 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.

# Submit a signed future-artwork edit

> Sign the exact packEditMessage from catalog/pack-edits.ts, after canonical parsePackEdit. Creator, runtime, launch transaction, nonce, expiry and revision are checked. Card edits have a seven-day window; cover edits do not use that same window. Previous openings retain their original revision. Validation/revision errors return 400; reload and reconcile rather than silently overwriting. Body <=512 KiB.



## OpenAPI

````yaml /api-reference/vibemarket_openapi.json post /runtime/{version}/pack-edit
openapi: 3.0.3
info:
  title: vibe.market API
  version: '2026-09-10'
  description: >-
    Consumer HTTP API for the current vibe.market at
    https://vibechain.com/market. This is an experimental protocol; review
    https://vibechain.com/terms. Public reads do not require Classic API keys.
    Discover runtime graphs rather than hardcoding a revision. The
    /api/vibemarket2 namespace is intentional. Operational provider webhooks and
    operator-only controls are excluded.
  termsOfService: https://vibechain.com/terms
servers:
  - url: https://build.vibechain.com/api/vibemarket2
    description: Current-market backend
security: []
tags:
  - name: Discovery
  - name: Indexed market
  - name: Board
  - name: Live updates
  - name: Creators
  - name: Artwork
  - name: Accounts
  - name: Community
  - name: Private messages
  - name: Scoped sessions
paths:
  /runtime/{version}/pack-edit:
    post:
      tags:
        - Creators
      summary: Submit a signed future-artwork edit
      description: >-
        Sign the exact packEditMessage from catalog/pack-edits.ts, after
        canonical parsePackEdit. Creator, runtime, launch transaction, nonce,
        expiry and revision are checked. Card edits have a seven-day window;
        cover edits do not use that same window. Previous openings retain their
        original revision. Validation/revision errors return 400; reload and
        reconcile rather than silently overwriting. Body <=512 KiB.
      operationId: vm2027
      parameters:
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: >-
            Runtime id from /runtime/versions or catalog/sources; never infer
            the newest revision from its name.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignedPackEdit'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PackEditSnapshot'
        '400':
          description: Invalid input, signature, cursor or action.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: Request body too large.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate/admission limit. Honor Retry-After if present.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Dependency, projection or capacity unavailable. Retry with backoff.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
components:
  schemas:
    SignedPackEdit:
      allOf:
        - $ref: '#/components/schemas/SignatureEnvelope'
        - type: object
          properties:
            edit:
              $ref: '#/components/schemas/PackEdit'
          required:
            - edit
    PackEditSnapshot:
      type: object
      properties:
        launchTx:
          type: string
        revision:
          type: integer
          format: int64
        owner:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        createdAt:
          type: integer
          format: int64
        editableUntil:
          type: integer
          format: int64
        effectiveAt:
          type: integer
          format: int64
        release:
          $ref: '#/components/schemas/ReleaseInput'
      required:
        - launchTx
        - revision
        - owner
        - createdAt
        - editableUntil
        - effectiveAt
        - release
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    SignatureEnvelope:
      type: object
      properties:
        address:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
        nonce:
          type: string
          format: uuid
          description: Fresh UUID v4, never reused.
        expires:
          type: integer
          format: int64
          description: >-
            Unix milliseconds; future and no more than five minutes from the
            server clock.
        signature:
          type: string
          pattern: ^0x[0-9a-fA-F]{130}$
      required:
        - address
        - nonce
        - expires
        - signature
      description: >-
        Sign the exact endpoint-specific message. A syntactically valid
        signature alone is not authorization.
    PackEdit:
      type: object
      properties:
        version:
          type: string
          pattern: ^[A-Za-z0-9-]{1,80}$
        dropId:
          type: string
          pattern: ^[1-9][0-9]{0,77}$
        launchTx:
          type: string
          pattern: ^0x[a-f0-9]{64}$
        revision:
          type: integer
          minimum: 0
        cardsByRarity:
          $ref: '#/components/schemas/CardsByRarity'
        image:
          type: string
          maxLength: 512
      required:
        - version
        - dropId
        - launchTx
        - revision
      description: >-
        At least image or cardsByRarity is required. Card edits are limited to
        seven days; cover edits have no equivalent time restriction.
    ReleaseInput:
      type: object
      properties:
        id:
          type: string
          pattern: ^[a-zA-Z0-9-]{1,64}$
        revision:
          type: integer
          minimum: 0
        name:
          type: string
          maxLength: 64
        symbol:
          type: string
          maxLength: 16
        image:
          type: string
          maxLength: 512
        color:
          type: string
          pattern: ^#[0-9a-fA-F]{6}$
        baseURI:
          type: string
          maxLength: 512
        description:
          type: string
          maxLength: 280
        links:
          type: object
          properties:
            website:
              type: string
            x:
              type: string
            telegram:
              type: string
        design:
          $ref: '#/components/schemas/PackDesign'
        launchAt:
          type: integer
          format: int64
          nullable: true
          minimum: 0
        status:
          type: string
          enum:
            - draft
            - announced
      required:
        - id
        - revision
        - name
        - symbol
        - image
        - color
        - baseURI
        - description
        - launchAt
        - status
      description: >-
        Announced releases require a nonempty name, uppercase alphanumeric
        symbol and non-null launchAt. load a full draft before saving if
        cardsOmitted is true.
    CardsByRarity:
      type: array
      minItems: 5
      maxItems: 5
      items:
        type: array
        maxItems: 50
        items:
          $ref: '#/components/schemas/CardDefinition'
    PackDesign:
      type: object
      properties:
        accent:
          type: string
          pattern: ^#[0-9a-fA-F]{6}$
        pattern:
          type: string
          enum:
            - solid
            - split
            - fade
            - stripes
        mask:
          type: string
          enum:
            - full
            - frame
            - art
            - paint
        cardsByRarity:
          $ref: '#/components/schemas/CardsByRarity'
        strokes:
          type: array
          maxItems: 12
          items:
            type: array
            minItems: 4
            maxItems: 80
            items:
              type: number
            description: >-
              Alternating x/y coordinates bounded by the design parser to
              x=0..300, y=0..420.
        tierImages:
          type: array
          items:
            type: string
        cardImage:
          type: string
        tierMasks:
          type: array
          items:
            type: string
      description: >-
        Normalized creator design. Use the shared parser for exact
        canonicalization before standalone signing.
    CardDefinition:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
          maxLength: 64
        description:
          type: string
          maxLength: 280
        image:
          type: string
          maxLength: 512
        mask:
          type: string
        firstEditionImage:
          type: string
          maxLength: 512
        attributes:
          type: array
          maxItems: 12
          items:
            type: object
            properties:
              trait_type:
                type: string
                maxLength: 32
              value:
                oneOf:
                  - type: string
                    maxLength: 128
                  - type: number
            required:
              - trait_type
              - value
      required:
        - id
        - name
        - description
        - image
        - attributes
      description: >-
        Do not override protocol-owned rarity, foil, wear or identity
        attributes.

````