> ## Documentation Index > Fetch the complete documentation index at: https://docs.gameboost.com/llms.txt > Use this file to discover all available pages before exploring further. # Update an item offer > Update an existing item offer's details including pricing, stock, description, and images. ## OpenAPI ````yaml /api/openapi.json patch /v2/item-offers/{itemOffer} openapi: 3.1.0 info: title: GameBoost version: 2.0.0 servers: - url: https://api.gameboost.com description: GameBoost API security: - BearerTokenSecurityScheme: [] tags: - name: Games description: Games - name: Seller Breaks description: Seller Breaks - name: Payments description: Payments - name: Payouts description: Payouts - name: Account Offers description: Account Offers - name: Account Orders description: Account Orders - name: Item Offers description: Item Offers - name: Item Orders description: Item Orders - name: Currency Offers description: Currency Offers - name: Currency Orders description: Currency Orders - name: Webhooks description: Webhook events sent to your endpoints when specific actions occur - name: Gift Card Offers description: Gift Card Offers - name: Gift Card Orders description: Gift Card Orders paths: /v2/item-offers/{itemOffer}: patch: tags: - Item Offers summary: Update an item offer description: >- Update an existing item offer's details including pricing, stock, description, and images. parameters: - name: itemOffer in: path description: >- The ID of the item offer. Can be retrieved from the list of item offers. required: true schema: type: string requestBody: description: >- Update item offer - all fields are optional, only provide fields you want to update content: application/json: schema: type: object properties: game_id: description: >- Unique identifier for the game (required if game slug not provided) type: integer game: description: Slug of the game (required if game_id not provided) type: string external_id: description: >- External identifier for the item offer, used to map to your own system type: string maxLength: 255 title: description: Display title for the item offer type: string maxLength: 255 slug: description: >- Custom URL-friendly identifier (auto-generated if not provided) type: string maxLength: 255 description: description: Detailed description of the items and what is included type: string maxLength: 2048 price: description: Price per unit in EUR currency, up to 2 decimal places type: number minimum: 0.01 example: 9.99 stock: description: Available quantity of items in stock type: integer maximum: 1000000000 minimum: 0 example: 50 min_quantity: description: Minimum quantity that can be purchased in a single order default: 1 type: integer maximum: 1000000000 minimum: 1 example: 1 delivery_instructions: description: >- Special instructions for item delivery, provided to buyer after purchase type: string delivery_method: description: >- Optional delivery method. If null, no item precheckout delivery form is shown. enum: - none - username - login - trade - auction - gift - redeem - mail type: string nullable: true excluded_delivery_fields: description: >- Optional delivery fields disabled by the seller. Required fields for the selected method cannot be excluded. type: array items: enum: - username - server - login - password - platform - region type: string nullable: true delivery_time: description: Expected delivery time object type: object properties: duration: description: Numeric value representing the delivery time type: integer unit: description: Time unit for the duration enum: - minutes - hours - days type: string example: duration: 24 unit: hours image_urls: description: >- Array of image URLs showcasing the items. Only one image is required. Recommended: transparent square images for best display. Note: Imgur URLs are not supported type: array items: description: Image URL type: string minItems: 1 example: - https://example.com/item1.jpg item_data: description: >- Specifics available via the [template endpoint](/api/reference/item-offers/get-item-offer-template). Game-specific item attributes such as rarity, type, or category type: object example: rarity: legendary type: skin responses: '200': description: A single item offer content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/ItemOffer' '401': $ref: '#/components/responses/ErrorUnauthenticated' '403': $ref: '#/components/responses/ErrorForbidden' '404': $ref: '#/components/responses/ErrorNotFound' '422': $ref: '#/components/responses/ErrorValidation' '429': $ref: '#/components/responses/ErrorRateLimited' security: - BearerToken: [] components: schemas: ItemOffer: description: Item offer object representing in-game items for sale type: object properties: id: description: Unique identifier for the item offer type: integer external_id: description: >- External identifier for the item offer, used to map to your own system type: string nullable: true game: $ref: '#/components/schemas/GameRelation' title: description: Display name for the item offer type: string slug: description: URL-friendly identifier for the item offer type: string description: description: Detailed description of the items and what is included type: string nullable: true parameters: description: >- Game-specific item parameters such as server, region, or item attributes type: object nullable: true status: description: Current status of the item offer enum: - draft - listed - archived type: string delivery_time: $ref: '#/components/schemas/DeliveryTime' delivery_instructions: description: >- Special instructions for item delivery, provided to buyer after purchase type: string nullable: true delivery_method: description: Delivery method used to collect customer precheckout information enum: - none - username - login - trade - auction - gift - redeem - mail type: string nullable: true excluded_delivery_fields: description: Optional delivery fields disabled by the seller type: array items: enum: - username - server - login - password - platform - region type: string delivery_method_data: description: >- Resolved delivery method metadata and customer fields after game-specific label overrides type: object nullable: true stock: description: Available quantity of items in stock type: integer min_quantity: description: Minimum quantity that can be purchased in a single order type: integer price_eur: description: Price per unit in EUR currency type: string price_usd: description: Price per unit converted to USD using current exchange rates type: string views: description: Total number of times this item offer has been viewed type: integer image_urls: description: Array of image URLs showcasing the items type: array items: type: string nullable: true created_at: description: Unix timestamp when the item offer was created type: integer updated_at: description: Unix timestamp of the last modification to the item offer type: integer listed_at: description: Unix timestamp when the item offer was made publicly available type: integer nullable: true GameRelation: description: Basic game information used in relations type: object properties: id: description: Unique identifier for the game type: integer name: description: Display name of the game type: string slug: description: URL-friendly identifier for the game type: string DeliveryTime: description: Delivery time object representing expected delivery duration type: object properties: duration: description: Numeric value representing the delivery time type: integer unit: description: Time unit for the duration (minutes, hours, days) enum: - minutes - hours - days type: string format: description: Human-readable delivery time (e.g., "2 hr") type: string format_long: description: Extended format delivery time (e.g., "2 hours") type: string seconds: description: Total delivery time converted to seconds type: integer responses: ErrorUnauthenticated: description: >- User is not authenticated, happens when the API key is missing, expired or invalid content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. ErrorForbidden: description: >- User is not authorized to perform this action, happens when you try to access a resource you do not have permission to access content: application/json: schema: type: object properties: message: type: string example: This action is unauthorized. ErrorNotFound: description: Resource not found, happens when the requested resource does not exist content: application/json: schema: type: object properties: message: type: string example: Resource not found. ErrorValidation: description: Validation errors, happens when the request data is invalid content: application/json: schema: type: object properties: message: type: string example: The given data was invalid. errors: type: object additionalProperties: type: array items: type: string example: field: - Something is wrong with this field! ErrorRateLimited: description: >- Rate limit exceeded, happens when you exceed the rate limit for the endpoint content: application/json: schema: type: object properties: message: type: string example: Too many requests. securitySchemes: BearerToken: type: http scheme: bearer bearerFormat: JWT ````