> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dezerx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a news post (public)

> One post with its Markdown content. The public API only returns published posts visible to guests, and answers 404 for everything when the News section is set to members only.

This is the public, keyless version. It only returns what an anonymous visitor can see on your site, is cached for 60 seconds (edits in the admin area show up at once) and allows 60 requests per minute per IP.

**Authentication:** none, no API key needed.

**Rate limit:** 60 requests per minute per IP.



## OpenAPI

````yaml /docs/modules-api.yaml get /public/modules/news/posts/{post}
openapi: 3.1.0
info:
  title: Spartan Module API
  version: '2026.11'
  description: >-
    Endpoints added by modules. Key endpoints live under
    `/api/application/modules/<module>/` and need an API key with the module
    permission. Content modules (Blog, News, Knowledge Base, Status) also offer
    keyless read only endpoints under `/api/public/modules/<module>/` that only
    return what an anonymous visitor can see.
servers:
  - url: https://{domain}/api
    description: Your Spartan installation
    variables:
      domain:
        default: billing.example.com
        description: Domain of your Spartan installation, without https://
security:
  - bearerAuth: []
tags:
  - name: Blog
  - name: Blog (public)
  - name: News
  - name: News (public)
  - name: Knowledge Base
  - name: Knowledge Base (public)
  - name: Status
  - name: Status (public)
  - name: Forms
  - name: Affiliates
  - name: Deprecated endpoints
paths:
  /public/modules/news/posts/{post}:
    get:
      tags:
        - News (public)
      summary: Get a news post (public)
      description: >-
        One post with its Markdown content. The public API only returns
        published posts visible to guests, and answers 404 for everything when
        the News section is set to members only.


        This is the public, keyless version. It only returns what an anonymous
        visitor can see on your site, is cached for 60 seconds (edits in the
        admin area show up at once) and allows 60 requests per minute per IP.


        **Authentication:** none, no API key needed.


        **Rate limit:** 60 requests per minute per IP.
      operationId: getNewsPostPublic
      parameters:
        - name: post
          in: path
          required: true
          description: Post slug. The key API also accepts the numeric id.
          schema:
            type: string
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/NewsPost'
                  meta:
                    $ref: '#/components/schemas/Meta'
                required:
                  - data
                  - meta
              example:
                data:
                  id: 4
                  title: Our new control panel is live
                  slug: new-control-panel
                  url: https://billing.example.com/news/new-control-panel
                  description: >-
                    Short interruptions on Saturday night while we upgrade the
                    network.
                  icon: null
                  layout: authenticated
                  og_image: https://billing.example.com/storage/news/frankfurt.png
                  meta_title: null
                  meta_description: null
                  reactions_enabled: true
                  reaction_counts: {}
                  published_at: '2026-04-03T09:08:43Z'
                  created_at: '2026-04-03T09:08:43Z'
                  updated_at: '2026-04-03T09:08:43Z'
                  content: >-
                    # Welcome to Our News Article


                    This is a sample news article written in Markdown. You can
                    edit this content using the editor below.


                    ## Getting Started


                    Replace this content with your own news article. You can use
                    standard Markdown syntax:


                    - **Bold text** for emphasis

                    - *Italic text* for subtle emphasis

                    - [Links](https://example.com) to external resources

                    - > Blockquotes for important information

                    - `Inline code` for technical terms


                    ## Features


                    - Full Markdown support

                    - Responsive design

                    - SEO optimization

                    - User reactions (if enabled)

                    - Custom permissions


                    ## Code Examples


                    ```javascript


                    ...
                meta:
                  request_id: 73b5c5f0-5725-402a-9b95-9d3b4978b9b0
          headers:
            Cache-Control:
              description: '`public, max-age=60`.'
              schema:
                type: string
            X-Cache:
              description: '`HIT` when served from the 60 second cache, `MISS` otherwise.'
              schema:
                type: string
                enum:
                  - HIT
                  - MISS
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in the current minute.
              schema:
                type: integer
        '404':
          description: Not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                not_found:
                  summary: Unknown, unpublished or members only
                  value:
                    error:
                      code: not_found
                      message: News post not found.
                      details: {}
                    request_id: 3f6c2a1e-8b4d-4f7a-9c2e-5d1b7a9e0c42
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security: []
components:
  schemas:
    NewsPost:
      type: object
      properties:
        id:
          type: integer
          description: Post id.
        title:
          type: string
        slug:
          type: string
        url:
          type: string
          format: uri
          description: Public URL of the post.
        description:
          type:
            - string
            - 'null'
        icon:
          type:
            - string
            - 'null'
        layout:
          type: string
          enum:
            - app
            - authenticated
          description: Page layout used on the site.
        og_image:
          type:
            - string
            - 'null'
          description: Absolute image URL.
        meta_title:
          type:
            - string
            - 'null'
        meta_description:
          type:
            - string
            - 'null'
        reactions_enabled:
          type: boolean
        reaction_counts:
          type:
            - object
            - 'null'
          properties: {}
          description: >-
            Reaction emoji to count. `null` when reactions are off or counts are
            hidden in the News settings.
          additionalProperties:
            type: integer
        published_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type:
            - string
            - 'null'
          format: date-time
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
        status:
          type: string
          enum:
            - published
            - scheduled
            - draft
          description: Key API only.
        visibility:
          type: string
          enum:
            - all
            - guest_only
            - authenticated_only
          description: Key API only. Who can see the post on the site.
        author:
          type:
            - object
            - 'null'
          properties:
            id:
              type: integer
            name:
              type: string
          description: Key API only.
        content:
          type: string
          description: >-
            Markdown body. On single post responses, or lists with
            `include_content=1`.
    Meta:
      type: object
      properties:
        request_id:
          type: string
          format: uuid
          description: Request id, also sent in the `X-Request-ID` response header.
      required:
        - request_id
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: >-
                Machine readable error code, for example `unauthorized`,
                `forbidden`, `not_found`, `invalid_service_state`.
            message:
              type: string
              description: Human readable explanation.
            details:
              type: object
              properties: {}
              description: Extra context. An empty object for most errors.
              additionalProperties: true
          required:
            - code
            - message
            - details
        request_id:
          type: string
          format: uuid
          description: >-
            Request id. Also returned in the `X-Request-ID` header. Send your
            own with `X-Request-ID` to correlate logs.
      description: Error envelope returned by every failed request.
      required:
        - error
        - request_id
  responses:
    TooManyRequests:
      description: Rate limit reached. Wait `Retry-After` seconds.
      headers:
        Retry-After:
          description: Seconds until the limit resets.
          schema:
            type: integer
        X-RateLimit-Limit:
          description: Requests allowed per minute.
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Requests left in the current minute.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: too_many_requests
              message: >-
                Too many requests. Retry after the number of seconds in the
                Retry-After header.
              details: {}
            request_id: db4f5a74-f1c8-4554-a36b-7dced81670a8
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key created in Admin, API. Send it as `Authorization: Bearer <key>`.
        Each key has its own permissions and optional IP allow list.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.