Skip to content
calternal docs

Replace a feed link

POST
/api/v1/calendar/feeds/{id}/link
curl --request POST \
  --url https://example.com/api/v1/calendar/feeds/example/link \
  --header 'Authorization: Bearer <token>'

Requires a signed-in User. It replaces the current link and returns the new link. The old link stops working. It returns 404 when the feed is missing. Route: /api/v1/calendar/feeds/{id}/link. Inputs: id. Do not automatically replay this operation after an uncertain result.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

One-time result returned only when a User creates or rotates a feed link.

object
feed_id
required

Stable ID used to open the owning feed’s Settings deep link.

string
https_url
required
string
webcal_url
required
string
Examplegenerated
{
  "feed_id": "example",
  "https_url": "example",
  "webcal_url": "example"
}

404

Section titled “404”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}