openapi: 3.2.0 info: title: WordPress.com REST API — wp/v2 namespace Settings API version: v2 description: Derived by API Evangelist from the WordPress.com REST API route index published at https://public-api.wordpress.com/wp/v2/. Paths, HTTP methods, and parameter names/types/descriptions/defaults are taken verbatim from that index. Response schemas are not published in the route index, so successful responses are described but not schematised; the error envelope was observed live on public-api.wordpress.com. contact: name: Automattic url: https://developer.wordpress.com/docs/api/ x-derived-from: https://public-api.wordpress.com/wp/v2/ x-derived-by: API Evangelist enrichment pipeline servers: - url: https://public-api.wordpress.com security: - bearerAuth: [] tags: - name: settings paths: /wp/v2/sites/{wpcom_site}/settings: get: operationId: getWpV2SitesbyWpcomSiteSettings summary: GET /wp/v2/sites/{wpcom_site}/settings tags: - settings responses: '200': description: OK '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/WPRestError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/WPRestError' parameters: - name: wpcom_site in: path required: true schema: type: string post: operationId: postWpV2SitesbyWpcomSiteSettings summary: POST /wp/v2/sites/{wpcom_site}/settings tags: - settings responses: '200': description: OK '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/WPRestError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/WPRestError' parameters: - name: wpcom_site in: path required: true schema: type: string requestBody: content: application/json: schema: type: object properties: active_templates: type: object wordpress_api_key: type: string description: API key for the Akismet Anti-spam connector. site_logo: type: integer description: Site logo. site_icon: type: integer description: Site icon. title: type: string description: Site title. description: type: string description: Site tagline. timezone: type: string description: A city in the same timezone as you. date_format: type: string description: A date format for all date strings. time_format: type: string description: A time format for all time strings. start_of_week: type: integer description: A day number of the week that the week should start on. language: type: string description: WordPress locale code. use_smilies: type: boolean description: Convert emoticons like :-) and :-P to graphics on display. default_category: type: integer description: Default post category. default_post_format: type: string description: Default post format. posts_per_page: type: integer description: Blog pages show at most. show_on_front: type: string description: What to show on the front page page_on_front: type: integer description: The ID of the page that should be displayed on the front page page_for_posts: type: integer description: The ID of the page that should display the latest posts default_ping_status: type: string enum: - open - closed description: Allow link notifications from other blogs (pingbacks and trackbacks) on new articles. default_comment_status: type: string enum: - open - closed description: Allow people to submit comments on new posts. gutenberg-experiments: type: object jetpack_social_image_generator_settings: type: object jetpack_social_utm_settings: type: object jetpack-social_show_pricing_page: type: boolean jetpack-social-note: type: boolean jetpack_social_notes_config: type: object jetpack_social_message_template: type: string cookie_consent_template: type: string Blogroll Recommendations: type: array items: type: object description: Site Recommendations put: operationId: putWpV2SitesbyWpcomSiteSettings summary: PUT /wp/v2/sites/{wpcom_site}/settings tags: - settings responses: '200': description: OK '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/WPRestError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/WPRestError' parameters: - name: wpcom_site in: path required: true schema: type: string requestBody: content: application/json: schema: type: object properties: active_templates: type: object wordpress_api_key: type: string description: API key for the Akismet Anti-spam connector. site_logo: type: integer description: Site logo. site_icon: type: integer description: Site icon. title: type: string description: Site title. description: type: string description: Site tagline. timezone: type: string description: A city in the same timezone as you. date_format: type: string description: A date format for all date strings. time_format: type: string description: A time format for all time strings. start_of_week: type: integer description: A day number of the week that the week should start on. language: type: string description: WordPress locale code. use_smilies: type: boolean description: Convert emoticons like :-) and :-P to graphics on display. default_category: type: integer description: Default post category. default_post_format: type: string description: Default post format. posts_per_page: type: integer description: Blog pages show at most. show_on_front: type: string description: What to show on the front page page_on_front: type: integer description: The ID of the page that should be displayed on the front page page_for_posts: type: integer description: The ID of the page that should display the latest posts default_ping_status: type: string enum: - open - closed description: Allow link notifications from other blogs (pingbacks and trackbacks) on new articles. default_comment_status: type: string enum: - open - closed description: Allow people to submit comments on new posts. gutenberg-experiments: type: object jetpack_social_image_generator_settings: type: object jetpack_social_utm_settings: type: object jetpack-social_show_pricing_page: type: boolean jetpack-social-note: type: boolean jetpack_social_notes_config: type: object jetpack_social_message_template: type: string cookie_consent_template: type: string Blogroll Recommendations: type: array items: type: object description: Site Recommendations patch: operationId: patchWpV2SitesbyWpcomSiteSettings summary: PATCH /wp/v2/sites/{wpcom_site}/settings tags: - settings responses: '200': description: OK '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/WPRestError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/WPRestError' parameters: - name: wpcom_site in: path required: true schema: type: string requestBody: content: application/json: schema: type: object properties: active_templates: type: object wordpress_api_key: type: string description: API key for the Akismet Anti-spam connector. site_logo: type: integer description: Site logo. site_icon: type: integer description: Site icon. title: type: string description: Site title. description: type: string description: Site tagline. timezone: type: string description: A city in the same timezone as you. date_format: type: string description: A date format for all date strings. time_format: type: string description: A time format for all time strings. start_of_week: type: integer description: A day number of the week that the week should start on. language: type: string description: WordPress locale code. use_smilies: type: boolean description: Convert emoticons like :-) and :-P to graphics on display. default_category: type: integer description: Default post category. default_post_format: type: string description: Default post format. posts_per_page: type: integer description: Blog pages show at most. show_on_front: type: string description: What to show on the front page page_on_front: type: integer description: The ID of the page that should be displayed on the front page page_for_posts: type: integer description: The ID of the page that should display the latest posts default_ping_status: type: string enum: - open - closed description: Allow link notifications from other blogs (pingbacks and trackbacks) on new articles. default_comment_status: type: string enum: - open - closed description: Allow people to submit comments on new posts. gutenberg-experiments: type: object jetpack_social_image_generator_settings: type: object jetpack_social_utm_settings: type: object jetpack-social_show_pricing_page: type: boolean jetpack-social-note: type: boolean jetpack_social_notes_config: type: object jetpack_social_message_template: type: string cookie_consent_template: type: string Blogroll Recommendations: type: array items: type: object description: Site Recommendations components: schemas: WPRestError: type: object description: WordPress REST API error envelope (observed on public-api.wordpress.com). properties: code: type: string example: rest_unauthorized message: type: string example: Authentication required. data: type: object properties: status: type: integer example: 401 securitySchemes: oauth2: type: oauth2 description: WordPress.com OAuth 2.1, per https://public-api.wordpress.com/.well-known/openid-configuration flows: authorizationCode: authorizationUrl: https://public-api.wordpress.com/oauth2-1/authorize tokenUrl: https://public-api.wordpress.com/oauth2-1/token refreshUrl: https://public-api.wordpress.com/oauth2-1/token scopes: global: '' auth: '' openid: '' profile: '' email: '' users: '' sites: '' posts: '' comments: '' taxonomy: '' follow: '' sharing: '' freshly-pressed: '' notifications: '' insights: '' read: '' stats: '' media: '' menus: '' batch: '' videos: '' bearerAuth: type: http scheme: bearer