Glasser
POST/v1/endpoints/inspect

Inspect one endpoint: schemas, price, version

Returns the full execution contract of one endpoint: the provider-native input JSON Schema, the output JSON Schema when a trustworthy one exists (null otherwise — samples never imply a contract), its source, the price with every charge clause, the current endpoint_version, the run mode, a sample input, and a link to the provider's own documentation. A sync endpoint also publishes timeout_ms, the maximum time from request to terminal response — set your HTTP client timeout above it. Passing endpoint_version pins the version you expect: anything other than the current version answers 409, the same rule run applies.

Request

bash
curl -X POST https://api.glasser.ai/v1/endpoints/inspect \
  -H "Authorization: Bearer gl_..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"...","endpoint":"..."}'

Body parameters

providerstringrequired
endpointstringrequired
endpoint_versionintegeroptional

Response

200
providerstringrequired
endpointstringrequired
endpoint_versionintegerrequired
namestringrequired
descriptionstringrequired
tagsstring[]required
priceobjectrequired
ruleobjectrequired
typeenumrequired
flat
amount_usdstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

chargesobjectrequired
NO_RESULTstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

PROVIDER_ERRORstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

TIMED_OUTstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

INTERNALstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

run_modeenumrequired
syncasync
timeout_msintegeroptional
methodenumrequired
GETPOSTPUTPATCHDELETEHEAD
input_schemaobjectrequired
output_schemaobjectrequired
output_schema_sourceenumrequired
providerglasser
sample_inputobjectrequired
doc_urlstringrequired

Errors

400validation_failedThe request does not satisfy the schema. details.issues lists the fields that failed, and details.location names the part of the request that carried them: Payload, Headers, Path, or Query.
401unauthorizedThe API key is missing, malformed, revoked, or unknown.
404not_foundThe resource does not exist, it does not belong to the workspace that the credentials are bound to, or the policy does not permit reading it.
409endpoint_version_mismatchThe endpoint_version in the request is no longer current. Inspect the endpoint again, then retry with the new version and its new terms.
429rate_limitedThe rate limit is exceeded. error.retry_after_ms tells you how long to wait.
500internal_errorThe server failed. The response body does not include internal details.

Authentication

Requires Bearer authentication. The workspace is bound to the API key, and you cannot change it with a request header.

Authorization: Bearer gl_...

Base URL: https://api.glasser.ai