GEgetsales
people

Suggest person filter values

Facet helper for building people filters - distinct values + row counts for one field within a filter scope (ES aggregation). field: company_name | tag_sids; term narrows by prefix/infix; typical scope filter = { playtable_sid: { eq } }. tag_sids returns tag sids with counts - resolve names via the tags tools. Feed a picked value into search filter eq/in. Profile facets (position, location, …) are playtable field values - facet via the cell-value tooling, not here.

Contract:

  • MCP tool suggest_person_filter_values, registry package mcp.playtables/people, mount playtables.people.
  • Operation action, response envelope action.
  • Flags: read only.
post/api/people/suggest

Request

  • Base URL
    https://beta.getsales.io/playtables/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

field'company_name' | 'tag_sids' required

Facet field: company_name (the resolved company name) | tag_sids (returns tag sids).

termstring

Prefix/infix narrowing; omit for top values.

limitinteger

1..50, default 20.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

itemunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.