Skip to content
Wink

Retrieve CalDAV connection

GET
/api/managing-entity/{managingEntityIdentifier}/extranet/caldav/auth
 
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/caldav/auth \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Retrieves the existing CalDAV connection details (authentication passkey and iCalendar feed URL) for the specified property. Returns 404 if the property has not yet configured CalDAV integration.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Unique identifier of the property for which to retrieve CalDAV configuration

Example 
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

CalDAV feed response containing authentication credentials and the subscription URL

object
identifier

Unique CalDAV record identifier

string format: uuid
""
hotelIdentifier

Unique property identifier for CalDAV authentication

string format: uuid
""
passkey

Secure passkey to authenticate requests against the CalDAV feed URL

string
""
url

The complete CalDAV feed URL to subscribe to from your calendar application

string
""
Example 
{
  "identifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
  "hotelIdentifier": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "passkey": "pkey_7fn92kd8s0x4m5qw9r3j1lp8n6t2u4v0",
  "url": "https://dev-api.wink.travel:8443/api/cal/property/a1b2c3d4-e5f6-7890-abcd-ef1234567890/booking/list"
}

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

401

Section titled “401 ”

Unauthorized — authentication is required or the session has expired

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

403

Section titled “403 ”

Forbidden — authenticated but lacking the required permission or scope

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

404

Section titled “404 ”

Not Found — the requested resource does not exist

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

405

Section titled “405 ”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

415

Section titled “415 ”

Unsupported Media Type — use application/json

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

500

Section titled “500 ”

Internal Server Error — an unexpected failure occurred on the server

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

503

Section titled “503 ”

Service Unavailable — a downstream dependency is unreachable

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example