List the models a model source exposes
Decrypts the stored key after re-checking access and asks the provider for its current model catalog, returning each model's id, context length, and provider-reported pricing. Requires `models:read`. Returns a not-found error for an unknown source and a fetch error when the provider is unreachable or rejects the key.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/model-sources/string/models"{ "data": { "models": [ { "id": "string", "label": "string", "description": "string", "contextLength": 0, "pricing": { "prompt": "string", "completion": "string" } } ] }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Delete a model source
Removes the provider key and its model selection from the workspace, so features relying on it fall back to the platform's own models. Requires `models:write` and returns a not-found error for an unknown source.
Unfurl an external URL into a link preview
Fetches the page named by the `url` query parameter server-side and returns its title, description, preview image, site name, and icon, parsed from Open Graph, Twitter card, and plain HTML tags. Requires the `workspace:read` permission. Only public http(s) URLs are resolved: other schemes, `localhost`, and private or loopback IP addresses are refused as validation errors, redirects are followed at most three times with each hop re-checked, the response body is read up to 512 KB, and non-HTML responses come back as a bare URL. Results are cached for a day per URL, and a missing `url`, an unreachable host, or a non-success response is reported as a validation or fetch error.