Manage membership tiers including creating, reading, and updating tier configurations with pricing and benefits.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/ghost-org:ghost-org-tiers-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Ghost Org Tiers API
version: '5.0'
termsOfService: https://ghost.org/terms/
description: 'Operations tagged Tiers across 2 of this provider''s published API definitions: ghost-org-admin-api-openapi.yml, ghost-org-content-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{site}.ghost.io/ghost/api/admin
description: Ghost Pro Hosted Site
variables:
site:
default: your-site
description: Your Ghost site subdomain
- url: '{protocol}://{domain}/ghost/api/admin'
description: Self-Hosted Ghost Instance
variables:
protocol:
default: https
enum:
- https
- http
domain:
default: localhost:2368
description: Your Ghost instance domain and port
- url: https://{site}.ghost.io/ghost/api/content
description: Ghost Pro Hosted Site
variables:
site:
default: your-site
description: Your Ghost site subdomain
- url: '{protocol}://{domain}/ghost/api/content'
description: Self-Hosted Ghost Instance
variables:
protocol:
default: https
enum:
- https
- http
domain:
default: localhost:2368
description: Your Ghost instance domain and port
tags:
- name: Tiers
description: Manage membership tiers including creating, reading, and updating tier configurations with pricing and benefits.
paths:
/tiers/:
get:
operationId: adminBrowseTiers
summary: Browse tiers
description: Retrieve a paginated list of membership tiers.
tags:
- Tiers
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page'
responses:
'200':
description: A list of tiers
content:
application/json:
schema:
type: object
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/Tier'
meta:
$ref: '#/components/schemas/PaginationMeta'
'401':
$ref: '#/components/responses/Unauthorized'
security:
- adminApiToken: []
post:
operationId: adminCreateTier
summary: Create a tier
description: Create a new membership tier with pricing, benefits, and visibility configuration.
tags:
- Tiers
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- tiers
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/TierInput'
minItems: 1
maxItems: 1
responses:
'201':
description: Tier created successfully
content:
application/json:
schema:
type: object
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/Tier'
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ValidationError'
security:
- adminApiToken: []
servers:
- url: https://{site}.ghost.io/ghost/api/admin
description: Ghost Pro Hosted Site
variables:
site:
default: your-site
description: Your Ghost site subdomain
- url: '{protocol}://{domain}/ghost/api/admin'
description: Self-Hosted Ghost Instance
variables:
protocol:
default: https
enum:
- https
- http
domain:
default: localhost:2368
description: Your Ghost instance domain and port
/tiers/{id}/:
get:
operationId: adminReadTier
summary: Read a tier by ID
description: Retrieve a single membership tier by its unique identifier.
tags:
- Tiers
parameters:
- $ref: '#/components/parameters/resourceId'
- $ref: '#/components/parameters/fields'
responses:
'200':
description: A single tier
content:
application/json:
schema:
type: object
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/Tier'
minItems: 1
maxItems: 1
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
security:
- adminApiToken: []
put:
operationId: adminUpdateTier
summary: Update a tier
description: Update an existing membership tier by its unique identifier.
tags:
- Tiers
parameters:
- $ref: '#/components/parameters/resourceId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- tiers
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/TierInput'
minItems: 1
maxItems: 1
responses:
'200':
description: Tier updated successfully
content:
application/json:
schema:
type: object
properties:
tiers:
type: array
items:
$ref: '#/components/schemas/Tier'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'422':
$ref: '#/components/responses/ValidationError'
security:
- adminApiToken: []
servers:
- url: https://{site}.ghost.io/ghost/api/admin
description: Ghost Pro Hosted Site
variables:
site:
default: your-site
description: Your Ghost site subdomain
- url: '{protocol}://{domain}/ghost/api/admin'
description: Self-Hosted Ghost Instance
variables:
protocol:
default: https
enum:
- https
- http
domain:
default: localhost:2368
description: Your Ghost instance domain and port
components:
responses:
Unauthorized:
description: Authentication failed or token is missing or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
ValidationError:
description: Request body validation failed
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
NotFound:
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized_2:
description: Authentication failed or API key is missing
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse_2'
parameters:
resourceId:
name: id
in: path
required: true
description: The unique identifier of the resource
schema:
type: string
format: uuid
page:
name: page
in: query
required: false
description: Page number for paginated results. Defaults to 1.
schema:
type: integer
minimum: 1
default: 1
filter:
name: filter
in: query
required: false
description: Apply fine-grained filters using Ghost's NQL query language.
schema:
type: string
fields:
name: fields
in: query
required: false
description: Comma-separated list of fields to return in the response.
schema:
type: string
limit:
name: limit
in: query
required: false
description: Maximum number of resources to return per page. Defaults to 15.
schema:
oneOf:
- type: integer
minimum: 1
- type: string
enum:
- all
default: 15
order:
name: order
in: query
required: false
description: Field and direction to order results by, for example published_at DESC or title ASC.
schema:
type: string
filter_2:
name: filter
in: query
required: false
description: Apply fine-grained filters using Ghost's NQL query language. Examples include featured:true, tag:getting-started, visibility:public, and combinations using plus and comma operators.
schema:
type: string
fields_2:
name: fields
in: query
required: false
description: Comma-separated list of fields to return in the response. Use this to limit the size of the response by only requesting the fields you need.
schema:
type: string
limit_2:
name: limit
in: query
required: false
description: Maximum number of resources to return per page. Defaults to 15. Use all to return all resources without pagination.
schema:
oneOf:
- type: integer
minimum: 1
- type: string
enum:
- all
default: 15
schemas:
PaginationMeta:
type: object
description: Pagination metadata
properties:
pagination:
type: object
properties:
page:
type: integer
description: Current page
minimum: 1
limit:
type: integer
description: Items per page
minimum: 1
pages:
type: integer
description: Total pages
minimum: 1
total:
type: integer
description: Total items
minimum: 0
next:
type: integer
description: Next page number
nullable: true
prev:
type: integer
description: Previous page number
nullable: true
ErrorResponse:
type: object
description: Standard Ghost API error response
properties:
errors:
type: array
items:
type: object
properties:
message:
type: string
description: Human-readable error message
type:
type: string
description: Error type identifier
context:
type: string
description: Additional error context
nullable: true
TierInput:
type: object
description: Input fields for creating or updating a tier.
required:
- name
properties:
name:
type: string
description: Tier name
description:
type: string
description: Tier description
nullable: true
active:
type: boolean
description: Whether the tier is active
visibility:
type: string
description: Public visibility
enum:
- public
- none
welcome_page_url:
type: string
format: uri
description: Welcome page URL
nullable: true
monthly_price:
type: integer
description: Monthly price in smallest currency unit
minimum: 0
yearly_price:
type: integer
description: Yearly price in smallest currency unit
minimum: 0
currency:
type: string
description: ISO 4217 currency code
pattern: ^[A-Z]{3}$
trial_days:
type: integer
description: Number of free trial days
minimum: 0
benefits:
type: array
description: Tier benefits
items:
type: string
Tier:
type: object
description: A membership tier with pricing and benefits configuration.
properties:
id:
type: string
format: uuid
description: Unique identifier
name:
type: string
description: Tier name
slug:
type: string
description: URL-safe slug
description:
type: string
description: Tier description
nullable: true
active:
type: boolean
description: Whether the tier is active
type:
type: string
description: Tier type
enum:
- free
- paid
welcome_page_url:
type: string
format: uri
description: Welcome page URL after signup
nullable: true
visibility:
type: string
description: Public visibility
enum:
- public
- none
monthly_price:
type: integer
description: Monthly price in smallest currency unit
nullable: true
minimum: 0
yearly_price:
type: integer
description: Yearly price in smallest currency unit
nullable: true
minimum: 0
currency:
type: string
description: ISO 4217 currency code
nullable: true
pattern: ^[A-Z]{3}$
trial_days:
type: integer
description: Number of free trial days
minimum: 0
benefits:
type: array
description: Tier benefits
items:
type: string
created_at:
type: string
format: date-time
description: Creation timestamp
updated_at:
type: string
format: date-time
description: Last update timestamp
PaginationMeta_2:
type: object
description: Pagination metadata included in browse responses
properties:
pagination:
type: object
properties:
page:
type: integer
description: Current page number
minimum: 1
limit:
type: integer
description: Number of items per page
minimum: 1
pages:
type: integer
description: Total number of pages
minimum: 1
total:
type: integer
description: Total number of items across all pages
minimum: 0
next:
type: integer
description: Next page number, null if on last page
nullable: true
prev:
type: integer
description: Previous page number, null if on first page
nullable: true
ErrorResponse_2:
type: object
description: Standard Ghost API error response
properties:
errors:
type: array
items:
type: object
properties:
message:
type: string
description: Human-readable error message
type:
type: string
description: Error type identifier
context:
type: string
description: Additional context about the error
nullable: true
Tier_2:
type: object
description: A tier represents a membership level in a Ghost publication with associated pricing and benefits.
properties:
id:
type: string
format: uuid
description: Unique identifier for the tier
name:
type: string
description: Name of the tier
slug:
type: string
description: URL-safe slug for the tier
description:
type: string
description: Description of the tier
nullable: true
active:
type: boolean
description: Whether the tier is currently active
type:
type: string
description: Type of tier
enum:
- free
- paid
welcome_page_url:
type: string
format: uri
description: URL of the welcome page shown after signup
nullable: true
created_at:
type: string
format: date-time
description: Timestamp when the tier was created
updated_at:
type: string
format: date-time
description: Timestamp when the tier was last updated
visibility:
type: string
description: Visibility of the tier
enum:
- public
- none
monthly_price:
type: integer
description: Monthly price in the smallest currency unit (e.g., cents)
nullable: true
minimum: 0
yearly_price:
type: integer
description: Yearly price in the smallest currency unit (e.g., cents)
nullable: true
minimum: 0
currency:
type: string
description: ISO 4217 currency code
nullable: true
pattern: ^[A-Z]{3}$
trial_days:
type: integer
description: Number of free trial days
minimum: 0
benefits:
type: array
description: List of benefits included in the tier
items:
type: string
securitySchemes:
adminApiToken:
type: http
scheme: bearer
bearerFormat: JWT
description: JSON Web Token generated from an Admin API key. The key is split into an ID and secret at the colon separator. The ID is used as the kid header and the secret is used to sign the token with HS256.
contentApiKey:
type: apiKey
in: query
name: key
description: Content API key obtained from a custom integration in Ghost Admin. Content API keys are safe for use in browsers and other insecure environments as they only provide access to public data.
x-refined-from:
- ghost-org-admin-api-openapi.yml
- ghost-org-content-api-openapi.yml