Skip to content

Update an attachment

Updates the resource identified by the following URL.This method changes the meta data of an attachment to a realestate Object.

PUT /offer/v1.0/user/{username}/realestate/{id}/attachment/{id}

Supported media types:
XML
JSON

Note: that binary code cannot be changed.

Request

Path Parameters

PARAMETER DESCRIPTION
Username the username which the user uses for logging in to www.immobilienscout24
me "me" can be used instead of the username, when the user is logged in by 3-legged oauth
Realestateid the real estate object id, which is generated, automatically

Example for a picture

XML: 

1
2
3
4
5
6
7
8
9
<common:attachment xsi:type="common:Picture" id="695671604" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<title>Test Logo</title>
<externalId>living3</externalId>

<externalCheckSum>checksum</externalCheckSum>

<floorplan>true</floorplan>
<titlePicture>true</titlePicture>
</common:attachment>

JSON: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{"common.attachment": {
@xmlns:{"common":"http:\/\/rest.immobilienscout24.de\/schema\/common\/1.0"},
"@xsi.type": "common:Picture",

"title": "bla",

"externalId": "kitchen2",
"externalCheckSum": "checksum",
"floorplan": "false",

"titlePicture": "false",
}}

Example for a PDF

XML: 

1
2
3
4
5
6
7
<common:attachment xsi:type="common:PDFDocument" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<title>TestDocument</title>
<externalId>living3</externalId>
<externalCheckSum>checksum</externalCheckSum>
<floorplan>true</floorplan>
<titlePicture>true</titlePicture>
</common:attachment>

JSON: 

1
2
3
4
5
6
7
8
{"common.attachment": {
@xmlns:{"common":"http:\/\/rest.immobilienscout24.de\/schema\/common\/1.0"},
"@xsi.type": "common:PDFDocument",
"title": "documenttitle",
"externalId": "kitchen2",
"externalCheckSum": "checksum",
"floorplan": "true",
}}

Example for a video

XML: 

1
2
3
4
5
6
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<common:attachment xsi:type="common:StreamingVideo" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<title>bla</title>
<externalId>kitchen2</externalId>
<externalCheckSum>checksum</externalCheckSum>
</common:attachment>

JSON: 

1
2
3
4
5
6
7
{"common.attachment": {
@xmlns:{"common":"http:\/\/rest.immobilienscout24.de\/schema\/common\/1.0"},
"@xsi.type": "common:StreamingVideo",
"title": "Title"
"externalId": "kitchen2",
"externalCheckSum": "checksum",
}}

Example for a video from URL

XML: 

1
2
3
4
5
6
<common:attachment xsi:type="common:Link" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:ns3="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<title>link test</title>

<externalId>kitchen2</externalId>
<externalCheckSum>checksum</externalCheckSum><url>http://youtube</url>
</common:attachment>

JSON: 

1
2
3
4
5
6
7
8
{"common.attachment": {
@xmlns:{"common":"http:\/\/rest.immobilienscout24.de\/schema\/common\/1.0"},
"@xsi.type": "common:Link",
"title": "urltitle",
"externalId": "kitchen2",
"externalCheckSum": "checksum",
"url": "http://test.de/abc",
}}