Introduction

The Weelkit API exposes the publishing-integration surface documented in this reference: organization custom article fields, API webhook destinations, and WordPress.com site discovery.

Authentication

Every request needs two things:

An Authorization: Bearer access token.
An X-Org-Id header identifying the organization the request acts on.

"securitySchemes": {
  "bearerAuth": {
    "type": "http",
    "scheme": "bearer"
  }
}

Endpoints that change organization configuration additionally require the manage:organization permission.

Concurrency

Revision checks apply to resources that declare revision and expectedRevision, including organization article fields. Send the revision you loaded on writes; a stale revision returns 409 Conflict and preserves the committed value. Webhook endpoint updates do not carry revision fields.

revision-scopes

[
  {
    "resource": "/api/v1/organization/webhooks",
    "readRevisionField": null,
    "writeExpectedRevisionField": null
  },
  {
    "resource": "organization-article-fields",
    "readRevisionField": "revision",
    "writeExpectedRevisionField": "expectedRevision"
  }
]

Errors

Errors share one shape:

{
  "code": "Validation",
  "message": "Field label is required."
}

Secrets are shown exactly once at creation or rotation and are never retrievable afterwards.

API documentation

Organization article fields

Webhooks

WordPress.com

Authentication

Concurrency

Errors

​Authentication

​Concurrency

​Errors

Authentication

Concurrency

Errors