WayloAIWaylo Docs
APIReferenceCatalogs

Create catalog

POST
/catalogs

Open an empty catalog in a workspace. Items are added separately.

Access: workspace_admin · API key catalogs:write

Authorization

api-key
headerAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>

Header Parameters

Authorization*string

Your API key.

Request Body

application/json
  1. body
workspaceId*string
Formatuuid
name*string
Lengthlength <= 100
description?|
Lengthlength <= 500
metadata?

Response Body

Created

application/json
  1. response
id*string
workspaceId*string
name*string
description*string|null
active*boolean
metadata*
itemCount*number
agents*array<>
createdByUserId*|
Formatuuid
createdByUserName*string|null
updatedByUserId*|
Formatuuid
updatedByUserName*string|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
Example Request
curl -X POST 'https://api.poc.app.waylovoice.ai/catalogs' \  -H 'Authorization: Bearer sk_waylo_...' \  -H 'Content-Type: application/json' \  -d '{  "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c",  "name": "string"}'
Example Response
{  "id": "string",  "workspaceId": "string",  "name": "string",  "description": "string",  "active": true,  "metadata": {},  "itemCount": 0,  "agents": [    {      "id": "string",      "name": "string"    }  ],  "createdByUserId": "4d2aef9a-17b0-44e6-902e-616812033620",  "createdByUserName": "string",  "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e",  "updatedByUserName": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Update agent PATCH

Change any part of the configuration except its workspace. An update that changes the configuration bumps `version` and records it in the history; one that changes nothing, or only `active`, does not. `documentIds` and `toolIds` each replace their whole set. Refused (409) if the resulting tools would give the model one function name twice — two tools sharing a name, or a tool shadowing a builtin of the resulting preset. **Access:** workspace_admin · API key `agents:write`

Create catalog items POST

Bulk upsert on `sku`. A field the batch omits keeps its stored value, so a partial re-post cannot revive a retired item; send `unit: null` to clear a unit. A batch naming one SKU twice, or an empty batch, is refused. **Access:** workspace_admin · API key `catalogs:write`