GraphQL API Overview

Endpoint

POST https://lnkify.io/graphql

A single endpoint for all queries and mutations. Powered by Apollo Server v5.

Content Type

All requests must use Content-Type: application/json.

Authentication

JWT or API key passed via HTTP headers. See Authentication for details.

• Authorization: Bearer <jwt> for JWT
• x-api-key: lf_live_<key> for API key

GraphiQL

Introspection is enabled in development mode for interactive exploration. Visit /graphql in a browser when NODE_ENV=development to open the GraphiQL IDE.

Making a Request

query {
  ping
}

curl -X POST https://lnkify.io/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"query": "query { ping }"}'

Response Format

Success

{
  "data": {
    "ping": "pong"
  }
}

Error

{
  "data": null,
  "errors": [
    {
      "message": "You must be logged in.",
      "extensions": { "code": "UNAUTHENTICATED" },
      "path": ["lnkifyConnection"]
    }
  ]
}

Rate Limits

120 requests per minute per identity. See Rate Limits for details.

Schema Introspection

The full schema is available via introspection in development mode. Use the standard __schema query or a GraphQL client to explore types, queries, and mutations at runtime.