> ## Documentation Index
> Fetch the complete documentation index at: https://api.housera.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Setează pozele

> Lista completă a pozelor, în ordine (prima e coperta): URL-uri de descărcat sau chei de upload presemnat. O poză care lipsește din listă se șterge. Răspunsul vine imediat (202); pozele se procesează în fundal, iar `media.processing` arată când s-a terminat.



## OpenAPI

````yaml ro/openapi.json PUT /listings/{code}/photos
openapi: 3.1.2
info:
  title: Housera API
  version: 1.0.0
  description: >-
    Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din
    aplicația ta, cu aceleași reguli ca formularul Housera.
servers:
  - url: https://staging.housera.ro/api/v1
    description: 'Sandbox (staging): date de test, aceleași reguli ca producția.'
  - url: https://housera.ro/api/v1
    description: 'Producție: anunțurile reale de pe housera.ro.'
security:
  - bearer: []
tags:
  - name: Anunțurile tale
  - name: Poze
  - name: Evenimente
  - name: Vocabular
paths:
  /listings/{code}/photos:
    put:
      tags:
        - Poze
      summary: Setează pozele
      description: >-
        Lista completă a pozelor, în ordine (prima e coperta): URL-uri de
        descărcat sau chei de upload presemnat. O poză care lipsește din listă
        se șterge. Răspunsul vine imediat (202); pozele se procesează în fundal,
        iar `media.processing` arată când s-a terminat.
      operationId: v1.listings.photos
      parameters:
        - name: code
          in: path
          required: true
          schema:
            type: string
          description: >-
            Codul public al anunțului (8 caractere, ca în adresa lui de pe
            Housera).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                photos:
                  type: array
                  items:
                    type: object
                    properties:
                      url:
                        type:
                          - string
                          - 'null'
                        format: uri
                        maxLength: 2048
                        description: Adresa.
                      key:
                        type:
                          - string
                          - 'null'
                        maxLength: 255
                        description: >-
                          Cheia fișierului urcat, de trimis apoi în
                          `photos[].key`.
                      floor:
                        type:
                          - string
                          - 'null'
                        description: Etajul.
                      rooms:
                        type:
                          - array
                          - 'null'
                        items:
                          type: string
                        maxItems: 3
                        description: Numărul de camere.
                  maxItems: 100
                  description: Fotografiile.
              required:
                - photos
      responses:
        '202':
          content:
            application/json:
              schema:
                type: object
                properties:
                  queued:
                    type: integer
                    description: >-
                      Câte poze au intrat la procesare. Rezultatul vine în
                      evenimentele `media.*`.
                required:
                  - queued
          description: 'Acceptat: se procesează în fundal.'
        '401':
          content:
            application/problem+json:
              schema:
                $ref: 2449e8cf-2469-4d15-b735-5241d23a2cba
          description: Cheia lipsește, e revocată sau a expirat (`unauthenticated`).
        '403':
          content:
            application/problem+json:
              schema:
                $ref: 2449e8cf-2469-4d15-b735-5241d23a2cba
          description: >-
            Cheia nu are dreptul cerut (`missing_ability`) sau accesul e refuzat
            (`forbidden`).
        '404':
          content:
            application/problem+json:
              schema:
                $ref: 2449e8cf-2469-4d15-b735-5241d23a2cba
          description: Anunțul nu există sau nu e al contului tău (`not_found`).
        '422':
          content:
            application/problem+json:
              schema:
                $ref: 23da4458-6a09-4e97-b93a-563e464e40c0
          description: >-
            Datele nu trec regulile: câte o intrare pe câmp în `errors[]`, cu un
            `code` stabil.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <key>'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.