GoodMemGoodMem
ReferenceAPIREST APIEmbedders

List embedders

GET /v1/embedders: Retrieves a list of embedder configurations accessible to the caller, with optional filtering.

Retrieves a list of embedder configurations accessible to the caller, with optional filtering.

LABEL FILTERS: Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).

AUTHORIZATION: Requires LIST_EMBEDDER on the GoodMem instance. Each returned embedder must also be visible through READ_EMBEDDER; unauthorized embedders are filtered in PostgreSQL. The ownerId parameter filters that already-authorized result set and does not grant additional visibility. This is a read-only operation with no side effects.

GET
/v1/embedders

Authorization

x-api-key<token>

In: header

Query Parameters

ownerId?string

Filter the already-authorized result set by owner principal UUID. Omitting this parameter does not bypass per-embedder READ_EMBEDDER filtering.

providerType?string

Filter embedders by provider type. Allowed values match the ProviderType schema.

Value in"OPENAI" | "VLLM" | "TEI" | "LLAMA_CPP" | "VOYAGE" | "COHERE" | "JINA"
label?object

Filter by label key-value pairs. Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).

Example{"environment":"production","team":"nlp"}

Empty Object

Response Body

curl -X GET "https://your-goodmem-server.example.com/v1/embedders?ownerId=550e8400-e29b-41d4-a716-446655440000&providerType=OPENAI&label%5Benvironment%5D=production&label%5Bteam%5D=nlp"
{
  "embedders": [
    {
      "embedderId": "550e8400-e29b-41d4-a716-446655440000",
      "displayName": "OpenAI Ada-2",
      "description": "OpenAI's text embedding model with 1536 dimensions",
      "providerType": "OPENAI",
      "endpointUrl": "https://api.openai.com/v1",
      "apiPath": "/embeddings",
      "modelIdentifier": "text-embedding-3-small",
      "dimensionality": 1536,
      "distributionType": "DENSE",
      "maxSequenceLength": 8192,
      "credentials": {
        "apiKey": {
          "inlineSecret": "sk-1234567890abcdef",
          "secretRef": {
            "uri": "vault://path/to/secret"
          },
          "headerName": "Authorization",
          "prefix": "Bearer "
        },
        "gcpAdc": {
          "scopes": [
            "https://www.googleapis.com/auth/cloud-platform"
          ],
          "quotaProjectId": "my-quota-project"
        }
      },
      "version": "1.0.0",
      "monitoringEndpoint": "https://monitoring.example.com/embedders/status",
      "ownerId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": 1617293472000,
      "updatedAt": 1617293472000,
      "createdById": "550e8400-e29b-41d4-a716-446655440000",
      "updatedById": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}
Empty
Empty
Empty

Get an embedder by ID

GET /v1/embedders/{id}: Retrieves the details of a specific embedder configuration by its unique identifier.

Update an embedder

PUT /v1/embedders/{id}: Updates an existing embedder configuration including display information, endpoint configuration, model parameters, credentials, and labels.