Read and manage model collections
List, create and update ShareAI Creator model collections with the required scopes and clear ownership and review boundaries.
On this page
A collection groups related model tags and their default serving/commercial policy. Individual model tags can have supported overrides. Use collection UUIDs returned by the API rather than display names.


https://api.shareai.now/api/v1/console/creator/model-collectionsList owned collections.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: creator UUID and creator access token
- Required scope
creator_collections:read
https://api.shareai.now/api/v1/console/creator/model-collections/{collection_uuid}Read one owned collection.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: creator UUID and creator access token
- Required scope
creator_collections:read
cURL
curl --fail-with-body --request GET \
"https://api.shareai.now/api/v1/console/creator/model-collections" \
-u "$CREATOR_UUID:$CREATOR_ACCESS_TOKEN"
Python
import json
import os
import urllib.request
import base64
credentials = os.environ["CREATOR_UUID"] + ":" + os.environ["CREATOR_ACCESS_TOKEN"]
headers = {"Authorization": "Basic " + base64.b64encode(credentials.encode()).decode()}
request = urllib.request.Request('https://api.shareai.now/api/v1/console/creator/model-collections', headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/console/creator/model-collections";
const credentials = `${process.env.CREATOR_UUID}:${process.env.CREATOR_ACCESS_TOKEN}`;
const headers: Record = {
Authorization: `Basic ${Buffer.from(credentials).toString("base64")}`,
};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Create a collection#
https://api.shareai.now/api/v1/console/creator/model-collectionsCreate a collection with a default access policy.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: creator UUID and creator access token
- Required scope
creator_collections:write
JSON
{
"name": "Example Research Model",
"collection_key": "example-research-model",
"description_html": "<p>A model for document classification. Describe intended use and limitations.</p>",
"share_types": [
"private"
]
}
Private availability keeps serving rights with the Creator’s own infrastructure. It does not mean the model must be absent from network inference. Use only share types enabled for the Creator program.
Update a collection#
https://api.shareai.now/api/v1/console/creator/model-collections/{collection_uuid}/updateUpdate permitted collection fields.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: creator UUID and creator access token
- Required scope
creator_collections:write
Read the current collection, send only the fields you intend to change and then read it again to verify the stored policy. Some published changes may need review before they become effective; inspect the returned state rather than treating a saved request as approval.
Choose a complete package when starting from scratch#
Create a model package groups model metadata, collection policy and tags in one request.
Last updated September 15, 2026