content_sources

7 operation(s). All run through POST /syteops/v1/manage/dispatch (reads may use the documented GET form).

approve_mapping

Approve a field mapping for a source, activating it for live ingest.

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	string	yes
mapping	object	yes

Returns

data: {id, status, mapping_status, mapping}

Request

{
  "resource": "content_sources",
  "action": "approve_mapping",
  "params": {
    "id": "string",
    "mapping": {}
  }
}

create

Create a content source; generates its id and slug, and (unless a secret is provided or auth_mode is none) a webhook secret.

Capability: manage_options

Parameters

Parameter	Type	Required	Description
name	string	yes
auth_mode	string	no
secret	string	no
default_author_id	integer	no
pin_author	boolean	no
target_post_type	string	no
new_cpt	object	no
meta_fields	object	no
fm_variables	object	no
forward_enabled	boolean	no
forward_url	url	no
forward_auth_mode	string	no
forward_secret	string	no
sig_header_mode	string	no
sig_header_name	string	no
ai_taxonomy_enabled	boolean	no
author_match_mode	string	no
target_tag_slug	string	no
taxonomy_apply_mode	string	no
strip_uncategorized	boolean	no
content_cleanup	boolean	no

Returns

data: {id, name, slug, secret, secret_source, ...} — secret is plaintext and NON-EMPTY only when secret_source is "generated" (empty for "provided"/"none"), returned only this once (forward_secret is never returned)

Request

{
  "resource": "content_sources",
  "action": "create",
  "params": {
    "name": "string",
    "auth_mode": "string",
    "secret": "string",
    "default_author_id": 0,
    "pin_author": true,
    "target_post_type": "string",
    "new_cpt": {},
    "meta_fields": {},
    "fm_variables": {},
    "forward_enabled": true,
    "forward_url": "https://example.com",
    "forward_auth_mode": "string",
    "forward_secret": "string",
    "sig_header_mode": "string",
    "sig_header_name": "string",
    "ai_taxonomy_enabled": true,
    "author_match_mode": "string",
    "target_tag_slug": "string",
    "taxonomy_apply_mode": "string",
    "strip_uncategorized": true,
    "content_cleanup": true
  }
}

delete

Permanently delete a content source.

🔴 Destructive — requires confirm: true.
Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	string	yes
confirm	boolean	no

Returns

data: {id, deleted: true}

Request

{
  "resource": "content_sources",
  "action": "delete",
  "params": {
    "id": "string",
    "confirm": true
  },
  "confirm": true
}

get

Get a single content source by id (never includes the secret).

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	string	yes

Returns

data: {id, name, slug, enabled, status, auth_mode, mapping, mapping_status, ...}

Request

{
  "resource": "content_sources",
  "action": "get",
  "params": {
    "id": "string"
  }
}

list

List all configured content sources (never includes the secret).

Capability: manage_options

Parameters

No parameters.

Returns

data.sources[]: array of {id, name, slug, enabled, status, auth_mode, target_post_type, cpt_post_type, shape_fingerprint, mapping, mapping_status, sample, default_author_id, pin_author, default_reviewers, default_ccs, default_post_status, meta_fields, fm_variables, forward_enabled, forward_url, forward_auth_mode, created_at, updated_at} (secret and forward_secret are never included)

Request

{
  "resource": "content_sources",
  "action": "list",
  "params": {}
}

rotate_secret

Generate a new webhook secret for a content source, invalidating the old one.

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	string	yes

Returns

data: {id, secret} — secret is plaintext, returned only this once

Request

{
  "resource": "content_sources",
  "action": "rotate_secret",
  "params": {
    "id": "string"
  }
}

update

Update editable fields on an existing content source (slug is not editable; secret is write-only).

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	string	yes
name	string	no
default_author_id	integer	no
pin_author	boolean	no
default_reviewers	object	no
default_ccs	object	no
default_post_status	string	no
auth_mode	string	no
secret	string	no
enabled	boolean	no
reingest_mode	string	no
target_post_type	string	no
meta_fields	object	no
fm_variables	object	no
forward_enabled	boolean	no
forward_url	url	no
forward_auth_mode	string	no
forward_secret	string	no
sig_header_mode	string	no
sig_header_name	string	no
ai_taxonomy_enabled	boolean	no
author_match_mode	string	no
target_tag_slug	string	no
taxonomy_apply_mode	string	no
strip_uncategorized	boolean	no
content_cleanup	boolean	no

Returns

data: {id, name, slug, ...} (no secret, no forward_secret)

Request

{
  "resource": "content_sources",
  "action": "update",
  "params": {
    "id": "string",
    "name": "string",
    "default_author_id": 0,
    "pin_author": true,
    "default_reviewers": {},
    "default_ccs": {},
    "default_post_status": "string",
    "auth_mode": "string",
    "secret": "string",
    "enabled": true,
    "reingest_mode": "string",
    "target_post_type": "string",
    "meta_fields": {},
    "fm_variables": {},
    "forward_enabled": true,
    "forward_url": "https://example.com",
    "forward_auth_mode": "string",
    "forward_secret": "string",
    "sig_header_mode": "string",
    "sig_header_name": "string",
    "ai_taxonomy_enabled": true,
    "author_match_mode": "string",
    "target_tag_slug": "string",
    "taxonomy_apply_mode": "string",
    "strip_uncategorized": true,
    "content_cleanup": true
  }
}