Skip to content Kleinanzeigen Public API Gateway Documentation
Kleinanzeigen Logo KA Api Documentation
PUT
/v1/listings/{uuid}/media/order
 
curl --request PUT \
  --url https://developer.kleinanzeigen.de/api/goods/v1/listings/123e4567-e89b-12d3-a456-426614174000/media/order \
  --header 'Content-Type: application/json' \
  --header 'HttpHeaders.AUTHORIZATION: eyJhbGciOiJIUzI1NiIsInR5...' \
  --data '{ "urls": [ "dfs/url1", "abc/url2", "xyz/url3" ] }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
uuid
required
string
Example 
123e4567-e89b-12d3-a456-426614174000

Header Parameters

Section titled “Header Parameters ”
HttpHeaders.AUTHORIZATION
required

Request Body required

Section titled “Request Body required ”

Ordered list of media URLs.

Media type application/json
object
urls
required
Array<string>
Example 
{
  "urls": [
    "dfs/url1",
    "abc/url2",
    "xyz/url3"
  ]
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Media order updated successfully

Media type application/json
object
uuid
required
string
category
required
string
title
required
string
description
required
string
attributes
required
object
key
additional properties
string
adType
required
string
adPrice
required
object
type
required
string
amount
required
number format: double
userId
required
string
email
required
string
phoneNumber
string | null
customReference
string | null
contactPerson
string | null
buyNow
boolean | null
urls
required
Array<string>
Example generated
{
  "uuid": "example",
  "category": "example",
  "title": "example",
  "description": "example",
  "attributes": {
    "additionalProperty": "example"
  },
  "adType": "example",
  "adPrice": {
    "type": "example",
    "amount": 1
  },
  "userId": "example",
  "email": "example",
  "phoneNumber": "example",
  "customReference": "example",
  "contactPerson": "example",
  "buyNow": true,
  "urls": [
    "example"
  ]
}

400

Section titled “400 ”

Bad request

Media type application/json
object
type
string format: uri
title
string | null
status
integer format: int32
detail
string | null
instance
string | null format: uri
properties
object | null
Example 
{
  "type": "about:blank",
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid ordering",
  "instance": "/api/v1/listings/123e4567-e89b-12d3-a456-426614174000/media/order",
  "localizedTitle": "",
  "localizedDetail": "",
  "localizedMessage": ""
}