The comments API from Brightseed — 7 operation(s) for comments, served by the WordPress REST API wp/v2 namespace on www.brightseedbio.com.
openapi: 3.1.0
info:
title: Brightseed Site Content API (WordPress REST API) comments API
version: wp/v2
description: Public content API for the Brightseed corporate site (www.brightseedbio.com), served by
the WordPress REST API `wp/v2` namespace. Read operations on posts, pages, categories, tags, users,
media, comments, search, taxonomies, types and statuses were verified to respond anonymously on 2026-07-31;
write operations require authentication via WordPress application passwords. This document was derived
by the API Evangelist enrichment pipeline from the route metadata the server itself publishes at https://www.brightseedbio.com/wp-json/wp/v2
— no operations, parameters or schemas were invented.
contact:
name: Brightseed
url: https://www.brightseedbio.com/contact-us/
servers:
- url: https://www.brightseedbio.com/wp-json
description: Brightseed WordPress REST API
security: []
tags:
- name: comments
paths:
/wp/v2/comments:
get:
operationId: listWpV2Comments
summary: GET /wp/v2/comments
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
- name: page
in: query
required: false
schema:
type: integer
default: 1
description: Current page of the collection.
- name: per_page
in: query
required: false
schema:
type: integer
default: 10
description: Maximum number of items to be returned in result set.
- name: search
in: query
required: false
schema:
type: string
description: Limit results to those matching a string.
- name: after
in: query
required: false
schema:
type: string
description: Limit response to comments published after a given ISO8601 compliant date.
- name: author
in: query
required: false
schema:
type: array
items:
type: integer
description: Limit result set to comments assigned to specific user IDs. Requires authorization.
- name: author_exclude
in: query
required: false
schema:
type: array
items:
type: integer
description: Ensure result set excludes comments assigned to specific user IDs. Requires authorization.
- name: author_email
in: query
required: false
schema:
type: string
default: null
description: Limit result set to that from a specific author email. Requires authorization.
- name: before
in: query
required: false
schema:
type: string
description: Limit response to comments published before a given ISO8601 compliant date.
- name: exclude
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Ensure result set excludes specific IDs.
- name: include
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Limit result set to specific IDs.
- name: offset
in: query
required: false
schema:
type: integer
description: Offset the result set by a specific number of items.
- name: order
in: query
required: false
schema:
type: string
enum:
- asc
- desc
default: desc
description: Order sort attribute ascending or descending.
- name: orderby
in: query
required: false
schema:
type: string
enum:
- date
- date_gmt
- id
- include
- post
- parent
- type
default: date_gmt
description: Sort collection by comment attribute.
- name: parent
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Limit result set to comments of specific parent IDs.
- name: parent_exclude
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Ensure result set excludes specific parent IDs.
- name: post
in: query
required: false
schema:
type: array
default: []
items:
type: integer
description: Limit result set to comments assigned to specific post IDs.
- name: status
in: query
required: false
schema:
type: string
default: approve
description: Limit result set to comments assigned a specific status. Requires authorization.
- name: type
in: query
required: false
schema:
type: string
default: comment
description: Limit result set to comments assigned a specific type. Requires authorization.
- name: password
in: query
required: false
schema:
type: string
description: The password for the post if it is password protected.
post:
operationId: createWpV2Comments
summary: POST /wp/v2/comments
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
author:
type: integer
description: The ID of the user object, if author was a user.
author_email:
type: string
description: Email address for the comment author.
author_ip:
type: string
description: IP address for the comment author.
author_name:
type: string
description: Display name for the comment author.
author_url:
type: string
description: URL for the comment author.
author_user_agent:
type: string
description: User agent for the comment author.
content:
type: object
description: The content for the comment.
date:
type: string
description: The date the comment was published, in the site's timezone.
date_gmt:
type: string
description: The date the comment was published, as GMT.
parent:
type: integer
default: 0
description: The ID for the parent of the comment.
post:
type: integer
default: 0
description: The ID of the associated post object.
status:
type: string
description: State of the comment.
meta:
type: object
description: Meta fields.
security:
- applicationPassword: []
/wp/v2/comments/{id}:
get:
operationId: getWpV2CommentsById
summary: GET /wp/v2/comments/{id}
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- &id001
name: id
in: path
required: true
schema:
type: integer
- name: context
in: query
required: false
schema:
type: string
enum:
- view
- embed
- edit
default: view
description: Scope under which the request is made; determines fields present in response.
- name: password
in: query
required: false
schema:
type: string
description: The password for the parent post of the comment (if the post is password protected).
post:
operationId: createWpV2CommentsById
summary: POST /wp/v2/comments/{id}
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
author:
type: integer
description: The ID of the user object, if author was a user.
author_email:
type: string
description: Email address for the comment author.
author_ip:
type: string
description: IP address for the comment author.
author_name:
type: string
description: Display name for the comment author.
author_url:
type: string
description: URL for the comment author.
author_user_agent:
type: string
description: User agent for the comment author.
content:
type: object
description: The content for the comment.
date:
type: string
description: The date the comment was published, in the site's timezone.
date_gmt:
type: string
description: The date the comment was published, as GMT.
parent:
type: integer
description: The ID for the parent of the comment.
post:
type: integer
description: The ID of the associated post object.
status:
type: string
description: State of the comment.
meta:
type: object
description: Meta fields.
parameters:
- *id001
security:
- applicationPassword: []
put:
operationId: replaceWpV2CommentsById
summary: PUT /wp/v2/comments/{id}
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
author:
type: integer
description: The ID of the user object, if author was a user.
author_email:
type: string
description: Email address for the comment author.
author_ip:
type: string
description: IP address for the comment author.
author_name:
type: string
description: Display name for the comment author.
author_url:
type: string
description: URL for the comment author.
author_user_agent:
type: string
description: User agent for the comment author.
content:
type: object
description: The content for the comment.
date:
type: string
description: The date the comment was published, in the site's timezone.
date_gmt:
type: string
description: The date the comment was published, as GMT.
parent:
type: integer
description: The ID for the parent of the comment.
post:
type: integer
description: The ID of the associated post object.
status:
type: string
description: State of the comment.
meta:
type: object
description: Meta fields.
parameters:
- *id001
security:
- applicationPassword: []
patch:
operationId: updateWpV2CommentsById
summary: PATCH /wp/v2/comments/{id}
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
author:
type: integer
description: The ID of the user object, if author was a user.
author_email:
type: string
description: Email address for the comment author.
author_ip:
type: string
description: IP address for the comment author.
author_name:
type: string
description: Display name for the comment author.
author_url:
type: string
description: URL for the comment author.
author_user_agent:
type: string
description: User agent for the comment author.
content:
type: object
description: The content for the comment.
date:
type: string
description: The date the comment was published, in the site's timezone.
date_gmt:
type: string
description: The date the comment was published, as GMT.
parent:
type: integer
description: The ID for the parent of the comment.
post:
type: integer
description: The ID of the associated post object.
status:
type: string
description: State of the comment.
meta:
type: object
description: Meta fields.
parameters:
- *id001
security:
- applicationPassword: []
delete:
operationId: deleteWpV2CommentsById
summary: DELETE /wp/v2/comments/{id}
tags:
- comments
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- *id001
- name: force
in: query
required: false
schema:
type: boolean
default: false
description: Whether to bypass Trash and force deletion.
- name: password
in: query
required: false
schema:
type: string
description: The password for the parent post of the comment (if the post is password protected).
security:
- applicationPassword: []
components:
schemas:
Error:
type: object
description: WordPress REST API error envelope.
properties:
code:
type: string
description: Machine-readable error code, e.g. rest_forbidden.
message:
type: string
description: Human-readable error message.
data:
type: object
properties:
status:
type: integer
securitySchemes:
applicationPassword:
type: http
scheme: basic
description: WordPress application passwords. Authorize at https://www.brightseedbio.com/wp-admin/authorize-application.php
(advertised in the /wp-json/ discovery document).
This is an independent, third-party profile of Brightseed comments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.