AI cost against credits settled

GET

/ai/admin/margin

curl --request GET \
  --url 'https://api.sloose.com/ai/admin/margin?creditMicroUsd=2000' \
  --header 'Authorization: Bearer <token>'

• Production

Backoffice route: a staff session, or ADMIN_TOKEN. What each feature cost us in provider spend against the credits we charged for it. Pass creditMicroUsd to price a credit and get revenue and margin columns; without it those come back null rather than guessed.

Authorizations

• sessionAuth
• adminToken

Parameters

Query Parameters

from

ISO start of the range. Defaults to the start of this month.

string

ISO start of the range. Defaults to the start of this month.

to

ISO end of the range, exclusive.

string

ISO end of the range, exclusive.

creditMicroUsd

What one credit sells for, in millionths of a USD.

string

Example

2000

What one credit sells for, in millionths of a USD.

Responses

200

Cost and margin by feature.

Media typeapplication/json

object

from

required

string

to

required

string

creditMicroUsd

required

number | null

totals

required

object

calls

required

number

costMicroUsd

required

number

creditsSettled

required

number

rows

required

Array<object>

object

key

additional properties

key

additional properties

Example^generated

{
  "from": "example",
  "to": "example",
  "creditMicroUsd": 1,
  "totals": {
    "calls": 1,
    "costMicroUsd": 1,
    "creditsSettled": 1
  },
  "rows": [
    {
      "additionalProperty": "example"
    }
  ]
}

400

from or to is not an ISO date.

Media typeapplication/json

object

error

required

string

code

required

string

Allowed values: BAD_INPUT

key

additional properties

Example

{
  "code": "BAD_INPUT"
}

401

A bearer that is neither the token nor a live session (code: AUTH_REQUIRED).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

403

A customer’s session, an API token, or no bearer at all — not staff, and not the ADMIN_TOKEN (code: ADMIN_REQUIRED).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

503

The restore switch is on (code: MAINTENANCE): every route but /health and /robots.txt is refused before anything is read, except the operator’s own POST /staff/people/{id}/delete with the ADMIN_TOKEN. Sloose is down for maintenance. Please try again in a few minutes.

Media typeapplication/json

object

error

required

string

code

required

string

Allowed value: MAINTENANCE

Example

{
  "code": "MAINTENANCE"
}

Headers

Retry-After

integer

Seconds until asking again is worth it (300 while the switch is on).