Skip to main content
POST
/
themes
Upload a theme
curl --request POST \
  --url https://registry.wp-content.io/themes \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-KEY: <api-key>' \
  --form theme='@example-file' \
  --form 'release_notes=Version update'
{
  "name": "My Theme",
  "slug": "my-theme",
  "version": "1.0.1",
  "preview_url": "",
  "author": {
    "user_nicename": "acme",
    "profile": "",
    "avatar": "",
    "display_name": "ACME",
    "author": "ACME",
    "author_url": "https://example.com"
  },
  "tags": [],
  "screenshot_url": null,
  "rating": 0,
  "num_ratings": 0,
  "downloaded": 0,
  "homepage": "",
  "description": "",
  "requires": null,
  "requires_php": null,
  "download_link": "https://wp-content-staging.s3.fr-par.scw.cloud/artifacts/themes/my-theme/my-theme-1.0.1-2f5fafc05b11f83c15a8b72ce15609c8.zip",
  "last_updated": "2025-06-11",
  "last_updated_time": "2025-06-11 11:33:13",
  "creation_time": "2025-06-11 11:32:43",
  "is_commercial": false,
  "external_support_url": false,
  "is_community": false,
  "external_repository_url": ""
}

Authorizations

X-API-KEY
string
header
required

Body

multipart/form-data
theme
file

Artifact for create or update a theme

release_notes
string

Release notes of the version

Example:

"Version update"

Response

OK

The response is of type object.