openapi: 3.1.0 info: title: Brightseed Site Content API (WordPress REST API) users 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: users paths: /wp/v2/users: get: operationId: listWpV2Users summary: GET /wp/v2/users tags: - users 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: 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: asc description: Order sort attribute ascending or descending. - name: orderby in: query required: false schema: type: string enum: - id - include - name - registered_date - slug - include_slugs - email - url default: name description: Sort collection by user attribute. - name: slug in: query required: false schema: type: array items: type: string description: Limit result set to users with one or more specific slugs. - name: roles in: query required: false schema: type: array items: type: string description: Limit result set to users matching at least one specific role provided. Accepts csv list or single role. - name: capabilities in: query required: false schema: type: array items: type: string description: Limit result set to users matching at least one specific capability provided. Accepts csv list or single capability. - name: who in: query required: false schema: type: string enum: - authors description: Limit result set to users who are considered authors. - name: has_published_posts in: query required: false schema: type: boolean description: Limit result set to users who have published posts. - name: search_columns in: query required: false schema: type: array default: [] items: type: string description: Array of column names to be searched. post: operationId: createWpV2Users summary: POST /wp/v2/users tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: - '' - en_US description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data required: - username - email - password security: - applicationPassword: [] /wp/v2/users/me: get: operationId: listWpV2UsersMe summary: GET /wp/v2/users/me tags: - users 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. post: operationId: createWpV2UsersMe summary: POST /wp/v2/users/me tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: &id001 - '' - en_US description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data security: - applicationPassword: [] put: operationId: replaceWpV2UsersMe summary: PUT /wp/v2/users/me tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: *id001 description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data security: - applicationPassword: [] patch: operationId: updateWpV2UsersMe summary: PATCH /wp/v2/users/me tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: *id001 description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data security: - applicationPassword: [] delete: operationId: deleteWpV2UsersMe summary: DELETE /wp/v2/users/me tags: - users 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: force in: query required: false schema: type: boolean default: false description: Required to be true, as users do not support trashing. - name: reassign in: query required: true schema: type: integer description: Reassign the deleted user's posts and links to this user ID. security: - applicationPassword: [] /wp/v2/users/{id}: get: operationId: getWpV2UsersById summary: GET /wp/v2/users/{id} tags: - users 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: - &id002 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. post: operationId: createWpV2UsersById summary: POST /wp/v2/users/{id} tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: &id003 - '' - en_US description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data parameters: - *id002 security: - applicationPassword: [] put: operationId: replaceWpV2UsersById summary: PUT /wp/v2/users/{id} tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: *id003 description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data parameters: - *id002 security: - applicationPassword: [] patch: operationId: updateWpV2UsersById summary: PATCH /wp/v2/users/{id} tags: - users 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: username: type: string description: Login name for the user. name: type: string description: Display name for the user. first_name: type: string description: First name for the user. last_name: type: string description: Last name for the user. email: type: string description: The email address for the user. url: type: string description: URL of the user. description: type: string description: Description of the user. locale: type: string enum: *id003 description: Locale for the user. nickname: type: string description: The nickname for the user. slug: type: string description: An alphanumeric identifier for the user. roles: type: array items: type: string description: Roles assigned to the user. password: type: string description: Password for the user (never included). meta: type: object description: Meta fields. elementor_introduction: type: object description: Elementor user meta data parameters: - *id002 security: - applicationPassword: [] delete: operationId: deleteWpV2UsersById summary: DELETE /wp/v2/users/{id} tags: - users 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: - *id002 - name: force in: query required: false schema: type: boolean default: false description: Required to be true, as users do not support trashing. - name: reassign in: query required: true schema: type: integer description: Reassign the deleted user's posts and links to this user ID. security: - applicationPassword: [] /wp/v2/users/{user_id}/application-passwords: get: operationId: getWpV2UsersByUserIdApplicationPasswords summary: GET /wp/v2/users/{user_id}/application-passwords tags: - users 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: - &id004 name: user_id in: path required: true schema: type: string - 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. post: operationId: createWpV2UsersByUserIdApplicationPasswords summary: POST /wp/v2/users/{user_id}/application-passwords tags: - users 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: app_id: type: string description: A UUID provided by the application to uniquely identify it. It is recommended to use an UUID v5 with the URL or DNS namespace. name: type: string description: The name of the application password. required: - name parameters: - *id004 security: - applicationPassword: [] delete: operationId: deleteWpV2UsersByUserIdApplicationPasswords summary: DELETE /wp/v2/users/{user_id}/application-passwords tags: - users 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: - *id004 security: - applicationPassword: [] /wp/v2/users/{user_id}/application-passwords/introspect: get: operationId: getWpV2UsersByUserIdApplicationPasswordsIntrospect summary: GET /wp/v2/users/{user_id}/application-passwords/introspect tags: - users 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: user_id in: path required: true schema: type: string - 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. /wp/v2/users/{user_id}/application-passwords/{uuid}: get: operationId: getWpV2UsersByUserIdApplicationPasswordsByUuid summary: GET /wp/v2/users/{user_id}/application-passwords/{uuid} tags: - users 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: - &id005 name: user_id in: path required: true schema: type: string - &id006 name: uuid in: path required: true schema: type: string - 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. post: operationId: createWpV2UsersByUserIdApplicationPasswordsByUuid summary: POST /wp/v2/users/{user_id}/application-passwords/{uuid} tags: - users 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: app_id: type: string description: A UUID provided by the application to uniquely identify it. It is recommended to use an UUID v5 with the URL or DNS namespace. name: type: string description: The name of the application password. parameters: - *id005 - *id006 security: - applicationPassword: [] put: operationId: replaceWpV2UsersByUserIdApplicationPasswordsByUuid summary: PUT /wp/v2/users/{user_id}/application-passwords/{uuid} tags: - users 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: app_id: type: string description: A UUID provided by the application to uniquely identify it. It is recommended to use an UUID v5 with the URL or DNS namespace. name: type: string description: The name of the application password. parameters: - *id005 - *id006 security: - applicationPassword: [] patch: operationId: updateWpV2UsersByUserIdApplicationPasswordsByUuid summary: PATCH /wp/v2/users/{user_id}/application-passwords/{uuid} tags: - users 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: app_id: type: string description: A UUID provided by the application to uniquely identify it. It is recommended to use an UUID v5 with the URL or DNS namespace. name: type: string description: The name of the application password. parameters: - *id005 - *id006 security: - applicationPassword: [] delete: operationId: deleteWpV2UsersByUserIdApplicationPasswordsByUuid summary: DELETE /wp/v2/users/{user_id}/application-passwords/{uuid} tags: - users 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: - *id005 - *id006 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).