Models and accounts

Endpoints

A model server you configured, and the free trial's allowance

Every built-in provider's catalogue is one fixed route, because there is one of each. Endpoints are user-created and unbounded, so the id rides in the address and the answer is whatever the configured server says about itself. The trial belongs here because the trial is an endpoint — the one the daemon provisions rather than you.

GET/endpoints/{id}/modelsModels a connected server offers

Asks one configured model server what it serves. There is no built-in list and no fallback: what a server offers is knowable only by asking it, so an empty answer is the honest report that we could not.

What you send

Field	Type	Where
`id`requiredWhich connection	string	address

What comes back

Field	Type
`models`What this provider serves, in its…	object[]
`id`What to name when asking for…	string
`label`What to call it on screen	string
`efforts`The thinking levels it accepts, where…	string[]
`description`What it is good for, in…	string
`badges`What it is known for, where…	"reasoning" \| "fast"[]
`contextWindow`How many tokens this model will…	number
`default`Which one a fresh conversation starts…	string

Try itanswered in this tab

curl

curl "$SANDBOX/endpoints/a1b2c3d4/models" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.endpoints.models({
  "id": "a1b2c3d4"
});

GET/endpoints/trial/statusWhat is left of the free trial

The allowance, what has been used, when it resets, and which model actually answered the last message. Not being available is the ordinary answer rather than a failure: most sandboxes run against a platform that offers no trial at all.

What you send

Nothing. Call it as it is.

What comes back

Field	Type
`available`	boolean
`allowance`	integer
`used`	integer
`remaining`	integer
`health`	"unknown" \| "healthy" \| "degraded" \| "unavailable"
`resetsAt`	string
`retryAt`	string
`servedModel`	string

Try itanswered in this tab

curl

curl "$SANDBOX/endpoints/trial/status" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.endpoints.trial();