Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/neuron-ng:neuron-ng-blog-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Neuron Blog API
version: 1.0.0
description: 'API reference for Neuron — the AI-powered WhatsApp chatbot platform.
Neuron lets you build intelligent chatbots with tool integrations, knowledge bases, and human-in-the-loop monitoring.
## Authentication
Most endpoints require a JWT bearer token obtained from `POST /auth/login`.
Bot API endpoints use API keys prefixed with `nrn_`.
The **Social API** (`/social`) is organization-scoped — authenticate with an **account token** (`nrn_acc_`, from Dashboard → Settings → Account Tokens). Bot API keys are also accepted for backward compatibility but are legacy for this API.
## Response Format
All responses follow the envelope: `{ success: boolean, data?: any, error?: { message, code } }`'
servers:
- url: /api/v1
description: API v1
tags:
- name: Blog
description: Blog posts, comments, and tags
paths:
/blog/posts:
get:
tags:
- Blog
summary: List published blog posts
security: []
description: Fetch paginated list of published blog posts. Optionally filter by tag, author type, or author ID.
parameters:
- name: page
in: query
schema:
type: string
description: 'Page number (default: 1)'
- name: limit
in: query
schema:
type: string
description: 'Items per page (default: 20, max: 100)'
- name: tag
in: query
schema:
type: string
description: Filter by tag slug
- name: authorType
in: query
schema:
type: string
description: Filter by author type (user or organization)
- name: authorId
in: query
schema:
type: string
description: Filter by author ID (user or organization UUID)
responses:
'200':
description: Paginated list
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/BlogPost'
total:
type: integer
page:
type: integer
limit:
type: integer
operationId: getBlogPosts
x-operation-id-source: derived
post:
tags:
- Blog
summary: Create blog post
security:
- BearerAuth: []
description: Create a new blog post as a draft or published. Author is determined by the authenticated user and organization.
requestBody:
content:
application/json:
schema:
type: object
required:
- title
- content
properties:
title:
type: string
maxLength: 255
content:
type: string
excerpt:
type: string
maxLength: 500
coverImageUrl:
type: string
format: uri
authorType:
type: string
enum:
- user
- organization
default: user
status:
type: string
enum:
- draft
- published
default: draft
readTimeMinutes:
type: integer
description: Auto-calculated from content if not provided
seoTitle:
type: string
seoDescription:
type: string
seoKeywords:
type: string
required: true
responses:
'201':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/BlogPost'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: postBlogPosts
x-operation-id-source: derived
/blog/posts/mine:
get:
tags:
- Blog
summary: Get own blog posts
security:
- BearerAuth: []
description: Fetch all blog posts authored by the authenticated user, including drafts.
parameters:
- name: page
in: query
schema:
type: string
description: Page number
- name: limit
in: query
schema:
type: string
description: Items per page
responses:
'200':
description: Paginated list
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/BlogPost'
total:
type: integer
page:
type: integer
limit:
type: integer
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getBlogPostsMine
x-operation-id-source: derived
/blog/posts/{slug}:
get:
tags:
- Blog
summary: Get blog post by slug
security: []
description: Fetch a single published blog post by its URL-friendly slug.
parameters:
- name: slug
in: path
required: true
schema:
type: string
description: Post slug (e.g., 'my-first-blog-post')
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/BlogPost'
'404':
description: Post not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getBlogPostsBySlug
x-operation-id-source: derived
/blog/posts/{id}:
put:
tags:
- Blog
summary: Update blog post
security:
- BearerAuth: []
description: Update an existing blog post. Only the author (user or organization) can update their posts.
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Post UUID
requestBody:
content:
application/json:
schema:
type: object
properties:
title:
type: string
content:
type: string
excerpt:
type: string
coverImageUrl:
type: string
format: uri
status:
type: string
enum:
- draft
- published
- archived
seoTitle:
type: string
seoDescription:
type: string
seoKeywords:
type: string
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/BlogPost'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: putBlogPostsById
x-operation-id-source: derived
delete:
tags:
- Blog
summary: Delete blog post
security:
- BearerAuth: []
description: Permanently delete a blog post. Only the author can delete their posts.
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Post UUID
responses:
'204':
description: Deleted successfully
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: deleteBlogPostsById
x-operation-id-source: derived
/blog/posts/{id}/publish:
post:
tags:
- Blog
summary: Publish blog post
security:
- BearerAuth: []
description: Change post status from draft to published. Sets publishedAt timestamp.
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Post UUID
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/BlogPost'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: postBlogPostsByIdPublish
x-operation-id-source: derived
/blog/tags:
get:
tags:
- Blog
summary: List all blog tags
security: []
description: Fetch all blog tags with post counts.
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: array
items:
$ref: '#/components/schemas/BlogTag'
operationId: getBlogTags
x-operation-id-source: derived
/blog/posts/{slug}/comments:
get:
tags:
- Blog
summary: Get comments for blog post
security: []
description: Fetch all visible comments for a blog post by slug.
parameters:
- name: slug
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: array
items:
$ref: '#/components/schemas/BlogComment'
'404':
description: Post not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getBlogPostsBySlugComments
x-operation-id-source: derived
post:
tags:
- Blog
summary: Add comment to blog post
security:
- BearerAuth: []
description: Post a comment on a blog post. Supports threaded comments via parentCommentId.
parameters:
- name: slug
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
required:
- content
properties:
content:
type: string
maxLength: 2000
parentCommentId:
type: string
format: uuid
description: Reply to a comment (optional)
authorOrgId:
type: string
format: uuid
description: Comment as organization (optional)
required: true
responses:
'201':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/BlogComment'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: postBlogPostsBySlugComments
x-operation-id-source: derived
components:
schemas:
BlogTag:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
slug:
type: string
postCount:
type: integer
BlogComment:
type: object
properties:
id:
type: string
format: uuid
postId:
type: string
format: uuid
authorUserId:
type:
- string
- 'null'
format: uuid
authorOrgId:
type:
- string
- 'null'
format: uuid
content:
type: string
parentCommentId:
type:
- string
- 'null'
format: uuid
status:
type: string
enum:
- visible
- hidden
- deleted
createdAt:
type: string
format: date-time
BlogPost:
type: object
properties:
id:
type: string
format: uuid
title:
type: string
slug:
type: string
content:
type: string
excerpt:
type: string
coverImageUrl:
type:
- string
- 'null'
format: uri
status:
type: string
enum:
- draft
- published
- archived
authorType:
type: string
enum:
- user
- organization
authorUserId:
type:
- string
- 'null'
format: uuid
authorOrgId:
type:
- string
- 'null'
format: uuid
readTimeMinutes:
type: integer
viewCount:
type: integer
seoTitle:
type:
- string
- 'null'
seoDescription:
type:
- string
- 'null'
seoKeywords:
type:
- string
- 'null'
publishedAt:
type:
- string
- 'null'
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
ErrorResponse:
type: object
properties:
success:
type: boolean
example: false
error:
type: object
properties:
message:
type: string
code:
type: string
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT access token from POST /auth/login
ApiKeyAuth:
type: http
scheme: bearer
description: Bot API key (nrn_xxx) from bot API keys management
AccountTokenAuth:
type: http
scheme: bearer
description: Account token (nrn_acc_xxx) from Dashboard > Settings > Account Tokens