Validate a read-only calendar feed

# Copy for LLM

Authorization

HTTP: bearerAuth

User bearer token. Default authentication for customer-facing endpoints. Obtain a token by calling POST /login with your credentials, then send it on every subsequent request as Authorization: Bearer <token>. The token inherits the permissions and PBX scope of the authenticated user.

HTTP Authorization Scheme

bearer

Bearer format

Bearer <token>

Request body · required · application/json

Request schema

url*string

example: https://example.com/calendar.ics

Responses

200 422 429

Feed preview with up to three upcoming occurrences

Response schema

Expand allCollapse all

name*string

eventCount*integer

nextEvents*array<object>

id*string

sourceId*string

title*string

start*string · date-time

end*string · date-time

isAllDay*boolean

locationstring | null

descriptionstring | null

urlstring | null

isTransparentboolean

The feed cannot be used. Field validation failures use the Laravel shape {message, errors} instead.

Response schema

errorCode*string

enum: invalid_url unreachable needs_sign_in not_a_calendar too_large

Too many feed requests, retry later

Response schema

No response body.

post https://cockpit.voxbi.com/api/v1/calendar-subscriptions/validate

Base URL The production API server The staging API server The development API server

Request sample cURL JavaScript Python PHP

Copy

curl -X POST 'https://cockpit.voxbi.com/api/v1/calendar-subscriptions/validate' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Copy

const response = await fetch('https://cockpit.voxbi.com/api/v1/calendar-subscriptions/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${YOUR_TOKEN}`,
  },
});

const data = await response.json();
console.log(data);

Copy

import requests

response = requests.post('https://cockpit.voxbi.com/api/v1/calendar-subscriptions/validate',
    headers={'Authorization': f'Bearer {YOUR_TOKEN}'}
)
response.raise_for_status()
data = response.json()
print(data)

Copy

<?php
$context = stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/json\r\nAuthorization: Bearer YOUR_TOKEN",
    ],
]);

$response = file_get_contents('https://cockpit.voxbi.com/api/v1/calendar-subscriptions/validate', false, $context);
$data = json_decode($response, true);
print_r($data);

Sample request

No request example provided.

Sample response

No example for this status.

Sample response

Expand all Collapse all Copy

{ … }

"errorCode": "unreachable"

}

Sample response

No example for this status.