Refresh a calendar subscription

# Copy for LLM

Authorization Parameters

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>

id path · string · uuid *

Responses

200 404 429

Subscription with refresh status

Response schema

id*string · uuid

name*string

color*string

enum: teal cyan blue indigo magenta pink rose red orange amber brown olive green slate

isVisible*boolean

maskedUrl*string

example: example.com…

lastSuccessfulRefreshAt*string | null · date-time

lastAttemptAt*string | null · date-time

status*string

enum: ok stale failing

errorCode*string | null

enum: invalid_url unreachable needs_sign_in not_a_calendar too_large null

Subscription not found

Response schema

No response body.

Refresh limit reached (1 per minute per subscription) or the shared per-user feed fetch limit (validate, store and refresh)

Response schema

No response body.

post https://cockpit.voxbi.com/api/v1/calendar-subscriptions/{id}/refresh

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/{id}/refresh' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Copy

const response = await fetch('https://cockpit.voxbi.com/api/v1/calendar-subscriptions/{id}/refresh', {
  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/{id}/refresh',
    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/{id}/refresh', false, $context);
$data = json_decode($response, true);
print_r($data);

Sample response

No example for this status.

Sample response

No example for this status.

Sample response

No example for this status.