Search the docs

Search guides, API endpoints and MCP tools.

Catalog

create_product

Write grant

Create a product: a piece of software the workspace tests, such as a website or an API. No other product, archived ones included, may use the slug or name. Returns the new product, which has no deployments yet. Needs write access.

Inputs

slugstringRequired

The product's slug: 2 to 48 lowercase letters, numbers or hyphens, such as storefront.

namestringRequired

The product's display name, up to 100 characters, such as Storefront.

typestringRequired

What kind of software the product is. Website and API products need a base URL in every deployment.

One ofwebsiteapiclimobile_appdesktop_appagent
descriptionstring

What the product is, up to 200 characters.

repositorystring

The source repository as owner/name, such as acme/storefront.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_product",    "arguments": {      "slug": "storefront",      "name": "Storefront",      "type": "website",      "description": "The Acme web store and its docs.",      "repository": "acme/storefront"    }  }}
POST/agent/v1/products:create
curl -X POST https://api.qa.clankership.net/agent/v1/products:create \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "slug": "storefront",    "name": "Storefront",    "type": "website",    "description": "The Acme web store and its docs.",    "repository": "acme/storefront"  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.