Sync a marketplace

⚠️
Preview — this feature is being built; the design below is the spec.
POST https://app.syntic.ai/v1/organizations/plugin_marketplaces/{marketplace_id}/sync

Fetch the marketplace now instead of waiting for the next automatic sync. Plugins removed from the index are marked blocked rather than deleted, so nothing disappears from members’ machines without a decision.

For how this fits into a full workflow, see Syntic Code plugins.

Headers

HeaderRequiredValue
AuthorizationYesBearer <admin key>: an Admin API key (sk_admin_...). Inference keys are refused with 403 admin_key_required. See Admin API keys.
syntic-betaYes, while in previewadmin-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.
Idempotency-KeyNoUp to 255 characters. Retrying with the same key within 24 hours returns the first result instead of acting twice. See Idempotency.

Path parameters

ParameterTypeDescription
marketplace_idstringThe marketplace id, starting with mkt_.

Response

202 Accepted, Content-Type: application/json

{
  "id": "mkt_01JCP2Q4S6U8W0Y2A4C6",
  "type": "plugin_marketplace",
  "sync": {
    "status": "running",
    "started_at": "2026-11-05T10:00:00Z"
  }
}

Examples

curl -sS -X POST "https://app.syntic.ai/v1/organizations/plugin_marketplaces/mkt_01JCP2Q4S6U8W0Y2A4C6/sync" \
  -H "Authorization: Bearer $SYNTIC_ADMIN_KEY" \
  -H "syntic-beta: admin-2026-11-01" \
  -H "Idempotency-Key: 8d6f0c1e-4b2a-4a57-9f0e-2f1d3c4b5a69"

Errors

Errors use the error envelope and carry a request_id. Codes specific to this operation:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
409conflict_errorsync_in_progressA sync is already running.
404not_found_errormarketplace_not_foundNo marketplace with this id.
401authentication_errorinvalid_api_keyThe admin key is missing, unknown, revoked or expired.
403permission_erroradmin_key_requiredAn inference key was used.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?