> ## 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 release action

> Direct backend signed action (mine, load, save, publish or wishlist). Sign the exact releaseMessage after parseAction canonicalization. Replay/expiry protected; maximum JSON body 512 KiB. Alternatively use an account releases action on the first-party website. This cannot launch a pool or spend tokens.



## OpenAPI

````yaml /api-reference/vibemarket_openapi.json post /releases
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:
  /releases:
    post:
      tags:
        - Creators
      summary: Submit a signed release action
      description: >-
        Direct backend signed action (mine, load, save, publish or wishlist).
        Sign the exact releaseMessage after parseAction canonicalization.
        Replay/expiry protected; maximum JSON body 512 KiB. Alternatively use an
        account releases action on the first-party website. This cannot launch a
        pool or spend tokens.
      operationId: vm2022
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignedRelease'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReleaseResponse'
        '400':
          description: Invalid input, signature, cursor or action.
          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:
    SignedRelease:
      allOf:
        - $ref: '#/components/schemas/SignatureEnvelope'
        - type: object
          properties:
            action:
              $ref: '#/components/schemas/ReleaseAction'
          required:
            - action
    ReleaseResponse:
      type: object
      properties:
        releases:
          type: array
          items:
            $ref: '#/components/schemas/Release'
        wishlist:
          type: array
          items:
            type: string
        wishedReleases:
          type: array
          items:
            $ref: '#/components/schemas/Release'
        more:
          type: boolean
        artworkHash:
          type: string
          pattern: ^[a-f0-9]{64}$
      required:
        - releases
        - wishlist
      description: >-
        Lists may omit full cards. A publish response can include artworkHash;
        publication is offchain, not a contract launch.
    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.
    ReleaseAction:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - mine
          required:
            - kind
        - type: object
          properties:
            kind:
              type: string
              enum:
                - load
            id:
              type: string
          required:
            - kind
            - id
        - type: object
          properties:
            kind:
              type: string
              enum:
                - save
                - publish
            release:
              $ref: '#/components/schemas/ReleaseInput'
          required:
            - kind
            - release
        - type: object
          properties:
            kind:
              type: string
              enum:
                - wishlist
            id:
              type: string
            wished:
              type: boolean
          required:
            - kind
            - id
            - wished
    Release:
      allOf:
        - $ref: '#/components/schemas/ReleaseInput'
        - type: object
          properties:
            owner:
              type: string
              pattern: ^0x[0-9a-fA-F]{40}$
            updatedAt:
              type: integer
              format: int64
            cardsOmitted:
              type: boolean
          required:
            - owner
            - updatedAt
    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.
    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.
    CardsByRarity:
      type: array
      minItems: 5
      maxItems: 5
      items:
        type: array
        maxItems: 50
        items:
          $ref: '#/components/schemas/CardDefinition'
    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.

````