StorytellerContent API

CORS, HEAD and OPTIONS

Use the API from browsers and HTTP clients.

CORS

Responses allow every browser origin with Access-Control-Allow-Origin: * and expose ETag to JavaScript through Access-Control-Expose-Headers: ETag. Every feed can therefore be read directly from a browser, with no key.

Every external GET route accepts HEAD and returns the corresponding GET status and headers with no response body, including failures and conditional 304.

head
curl --fail --silent --show-error --head 'https://api.live.storyos.ai/v1/fixtures/0042500401/feeds/pulse'

OPTIONS

OPTIONS on any path returns 204 with no body. A successful preflight does not establish that the path exists.

options
curl --silent --show-error --include --request OPTIONS \
  --header 'Origin: https://example.com' \
  --header 'Access-Control-Request-Method: GET' \
  --header 'Access-Control-Request-Headers: If-None-Match, Authorization' \
  'https://api.live.storyos.ai/v1/fixtures/0042500401/feeds/pulse'
Preflight headerValue
Access-Control-Allow-MethodsGET, HEAD, OPTIONS
Access-Control-Allow-HeadersIf-None-Match, Authorization
Access-Control-Max-Age86400

The browser may cache that preflight for up to 86,400 seconds; this is separate from caching the feed response.

On this page