API Reference

Foir provides a powerful GraphQL API for querying and managing your content.

Authentication

All API requests require authentication via a JWT token or API key.


# Include in headers
Authorization: Bearer YOUR_TOKEN

Common Queries

Fetching Content


query GetPage($id: ID!) {
  page(id: $id) {
    id
    title
    slug
    content
    publishedAt
  }
}

Listing Content


query ListPages($limit: Int, $offset: Int) {
  pages(limit: $limit, offset: $offset) {
    items {
      id
      title
      slug
    }
    total
  }
}

Mutations

Creating Content


mutation CreatePage($input: CreatePageInput!) {
  createPage(input: $input) {
    id
    title
  }
}

Publishing Content


mutation PublishPage($id: ID!) {
  publishPage(id: $id) {
    id
    publishedAt
  }
}

Rate Limits

API requests are subject to rate limiting to ensure fair usage:

Standard tier: 1000 requests per minute
Enterprise tier: Custom limits available