Lightweight semantic-context lookup designed for AI agents.

​

Returns a compact list of records most semantically relevant to the query. * Custom field values are emitted in short notation only (value, id, created, updated, * customFieldInputId, customFieldInputName) — no full DB representation. Designed for * AI agents that need lean context before acting; planned for future MCP-tool wrapping * so the response shape stays trivial to transform.

Query Parameters
  • space_id
    Type: integer
    min:  
    1
    required

    Tenant scope. Custom module derived from space.custom_module_id.

  • query
    Type: string
    min length:  
    1
    max length:  
    4000
    required
  • limit
    Type: integer
    min:  
    1

    Integer numbers.

  • filter
    Type: string

    Filter expression. Mutually exclusive with segment_id.

  • segment_id
    Type: integer
    min:  
    1

    Saved segment whose filter to apply. When present, the response includes fromSegment with the segment name.

Responses
  • application/json
  • 400

    Validation error.

  • 401

    Not authenticated.

  • 403

    User lacks read access to the requested space.

  • 405

    Method not GET.

  • 502

    Embedding provider call failed.

Request Example for get/record/vector/context
curl 'https://test.boost.space/api/record/vector/context?space_id=123&query=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "context": [
    {}
  ],
  "retrieved": 10,
  "fromSegment": "Enterprise Deals Q2"
}

Compact records.