Rensei docs
API ReferenceMarketplace

Install a model card as an org model library entry.

Install a model card as an org model library entry. - Rensei REST API operation reference.

POST
/api/marketplace/models/{id}/install

Authorization

headerAuthorizationBearer <WorkOS user access token>

WorkOS user access token created by the Rensei CLI. The authenticated organization is resolved from membership and may be narrowed with X-Rensei-Org.

Path Parameters

id*string

The model_catalog identity to install.

Length1 <= length

Request Body

application/json
  1. body
chosenCatalogIds?array<>

Confirmed servings in order: primary first, then selected fallbacks.

Items1 <= items <= 100
useOthersAsFallback?boolean

Also link other connected servings as fallbacks, excluding contributor policies.

Defaulttrue

Response Body

The model card was already installed; its existing pin is returned.

application/json
  1. response
entryId*string
servingId*string|null
availability*string
Value in"ready""needs_provider""attention"
installId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
contentItemId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
contentVersionId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
created*boolean
choices*array<>
useOthersAsFallback*boolean
Example Request
curl -X POST 'https://app.rensei.ai/api/marketplace/models/string/install' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "entryId": "string",  "servingId": "string",  "availability": "ready",  "installId": "b233bfe0-f705-4889-ae25-bbc86d012048",  "contentItemId": "1fc059aa-e013-431b-abf9-93fd7236b54b",  "contentVersionId": "a5a27b60-1951-4448-8e45-5c887f120534",  "created": true,  "choices": [    {      "catalogId": "string",      "provider": "string",      "pricing": null,      "preselected": true    }  ],  "useOthersAsFallback": true}

List model catalog identities available for org adoption.

List model catalog identities available for org adoption. - Rensei REST API operation reference.

Issue M2M access token (client_credentials)

OAuth 2.0 `client_credentials` grant. The canonical request media type is `application/x-www-form-urlencoded`; `application/json` remains accepted for backward wire compatibility. Returns a short-lived `Bearer` access token. M2M clients are provisioned in the admin panel (`POST /api/admin/m2m-clients`).