---
title: "Encode text to an embedding"
method: POST
path: "/v2/workspaces/{id}/encode"
tags: ["Runtime"]
---

# Encode text to an embedding

`POST /v2/workspaces/{id}/encode`

## Request

- Base URL: `https://api.infolang.ai`
- URL: `https://api.infolang.ai/v2/workspaces/{id}/encode`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Class A — accepts a session JWT, an `il_live_`/`il_test_` API key, or an `il_oauth_` token. On the `il_*` lanes the bearer is forwarded to Kairos verbatim and Kairos enforces the credential's grant on this workspace (its 401/403 is surfaced in the v2 envelope). The response body is Kairos's, passed through unchanged; `X-InfoLang-Tokens-Saved` / `X-InfoLang-Overage` are echoed when set.

Requires the `compute:read` scope. Accepts all three lanes: a session JWT (bounded by the caller's role on this workspace) or an `il_*` machine credential whose own scope set, workspace set and validity window cover it — both ceilings apply and neither can raise the other, so a credential carrying `compute:read` is still refused where the role does not permit it.

A credential with no scope record resolves to `LEGACY_DEFAULT`, which INCLUDES `compute:read` — every key minted before scoping keeps working here.

## Path parameters

- `id` string, required

## Request body

- object
  - `text` string, required

## Response `200`

Embedding vector (forge shape)

- object
  - `enc_ver` integer, required
  - `views_b64` string, required
  - `views_elems` integer, required
  - `rvq_codes_b64` string, required
  - `properties` object

## Other responses

- `401`: Missing/invalid credential
- `403`: The credential holds no grant on this workspace. Or `lane_not_supported` — the credential is well-formed but this route does not accept its lane
- `422`: Body failed the pinned kairos-runtime schema
- `502`: Upstream Kairos failure
- `503`: not_ready — Kairos ML backend still warming up

---

[API](https://skmtc.dev/infolang/apis/infolang-api.md) · [All operations](https://skmtc.dev/infolang/apis/infolang-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infolang/apis/infolang-api/revisions/d04bf6de72c8?raw)