API Documentation

TimelySocials API discovery resources

TimelySocials exposes a public health endpoint and a machine-readable API description so tools and agents can discover the service safely.

Base API URL

https://api.timelysocials.com/api/v1

API catalog

Machine-readable API catalog in application/linkset+json format.

Open resource

OpenAPI description

Compact OpenAPI document for discovery and agent tooling.

Open resource

Backend health

Health endpoint for uptime monitoring and status checks.

Open resource

Authentication model

Protected routes currently use first-party JWT access tokens.

Open resource

Authentication

TimelySocials protected routes currently use application-specific JWT access tokens with a refresh-token cookie for first-party app sessions. The site does not yet expose a standards-based OAuth 2.0 or OpenID Connect authorization server for third-party AI agents.