The plugin marketplace object
⚠️
Preview — this feature is being built; the design below is the spec.
The plugin_marketplace object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.
Example
{
"id": "mkt_01JCP2Q4S6U8W0Y2A4C6",
"type": "plugin_marketplace",
"name": "platform-team",
"url": "https://git.example.com/acme/syntic-plugins.git",
"ref": "main",
"auto_sync": true,
"plugin_count": 0,
"last_synced_at": null,
"last_sync_error": null,
"created_at": "2026-09-10T10:00:00Z"
}Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique id of this object. |
type | string | The object type, always plugin_marketplace. |
name | string | Name shown in the Console and in reports. |
url | string | A Git repository whose root holds a marketplace.json index. |
ref | string | See the endpoint pages below. |
auto_sync | boolean | Sync every 6 hours. New plugins arrive with policy available; existing policies are kept. |
plugin_count | integer | Plugins listed in the index. |
last_synced_at | string or null | See the endpoint pages below. |
last_sync_error | object or null | Why the last sync failed. |
created_at | string | When it was created, RFC 3339 UTC (some older objects use Unix seconds). |
Returned by
POST /v1/organizations/plugin_marketplacesGET /v1/organizations/plugin_marketplacesGET /v1/organizations/plugin_marketplaces/{marketplace_id}POST /v1/organizations/plugin_marketplaces/{marketplace_id}/sync
Was this page helpful?