---
title: "The workspace's plugins as a Codex marketplace [read]"
method: GET
path: "/plugins/marketplace.json"
---

# The workspace's plugins as a Codex marketplace \[read\]

`GET /plugins/marketplace.json`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/plugins/marketplace.json`
- Auth: HTTP bearer

A Codex marketplace root: `.agents/plugins/marketplace.json` listing each plugin with a local source (`./plugins/<name>`, policy AVAILABLE / ON_INSTALL) and every plugin's package under `plugins/<name>/`, as GET /plugins/{id}/export writes it. It holds the AgentSky plugin, every switched-on, unblocked bundle, every skill attached to new chats (not a bundle's) and every custom MCP server; `skipped` names what was left out and why. Write the files under one folder and run `codex plugin marketplace add <folder>`. 400 invalid_request without `format=codex`; 413 export_too_large past 64 MB.

## Query parameters

- `format` 'codex', required

## Response `200`

The marketplace

- object
  - `format` 'codex', required
  - `name` string, required: The marketplace's name, agentsky-<workspace>
  - `files` object[], required: Every file of an exported package or marketplace, by its path from the root
    - `path` string, required
    - `encoding` 'utf-8' | 'base64', required
    - `content` string, required
    - `executable` boolean: Present and true for a file to make executable
  - `plugins` object[], required
    - `plugin_id` string
    - `name` string
  - `skipped` object[], required
    - `plugin_id` string
    - `reason` string

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `0d435187cd55`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/plugins/marketplace.json/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/fa82707ab831?raw)