get/calendar/{token}.icsRead operation

GET /calendar/{token}.ics

Use the frozen API v0 contract to gET /calendar/{token}.ics. Returns legacy response envelopes and uses page-and-limit pagination where the route supports collection reads. Authentication scopes the request to the workspace that issued the token.

Request example

curl --request GET \
  --url 'https://api.teamgrid.app/calendar/TOKEN.ics' \
  --header 'Authorization: Bearer $TEAMGRID_API_TOKEN'

const response = await fetch('https://api.teamgrid.app/calendar/TOKEN.ics', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
  },
})

const result = await response.json()

type ApiResponse = unknown

const response = await fetch('https://api.teamgrid.app/calendar/TOKEN.ics', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
  },
})

const result: ApiResponse = await response.json()

Example response 2xx

{
  "data": null,
  "info": "string",
  "pagination": null,
  "status": null,
  "statusCode": 0
}

EndpointLegacy API

Path parameters

tokenrequired

string

Opaque calendar-feed token issued by TeamGrid. Treat this value as a secret.

Responses

200The legacy request to gET /calendar/{token}.ics succeeded and returned the historical v0 response envelope.application/json

Response schemaapplication/json

data

object

Response data for the completed request.

info

string

The info associated with this legacy.

pagination

objectnullable

The pagination associated with this legacy.

status

stringnullable

Canonical status of the resource or operation.

statusCoderequired

integer

HTTP status code represented by this legacy response envelope.

201The legacy request to gET /calendar/{token}.ics created a resource and returned the v0 response envelope.application/json

Response schemaapplication/json

data

object

Response data for the completed request.

info

string

The info associated with this legacy.

pagination

objectnullable

The pagination associated with this legacy.

status

stringnullable

Canonical status of the resource or operation.

statusCoderequired

integer

HTTP status code represented by this legacy response envelope.

204The request to gET /calendar/{token}.ics completed successfully and returns no response body.

400Legacy request failure.application/json

Response schemaapplication/json

data

object

Response data for the completed request.

info

string

The info associated with this legacy.

pagination

objectnullable

The pagination associated with this legacy.

status

stringnullable

Canonical status of the resource or operation.

statusCoderequired

integer

HTTP status code represented by this legacy response envelope.

401Authentication failed.application/json

Response schemaapplication/json

error

string

Sanitized failure information when the operation did not succeed.

message

string

Human-readable explanation intended to help diagnose the result.

statusCoderequired

integer

HTTP status code represented by this legacy response envelope.

429Rate limit exceeded.application/json

Response schemaapplication/json

error

string

Sanitized failure information when the operation did not succeed.

message

string

Human-readable explanation intended to help diagnose the result.

statusCoderequired

integer

HTTP status code represented by this legacy response envelope.

Operation IDv0_get_calendar_token_icsOpenAPI JSON ↗

Documentation feedbackWas this page useful?