count_records

POST/entities/{entity_id}/records/count

Authorization

AuthorizationBearer <token>

A service principal's credential, or a person's access token, AgentFlow's own or an installed app's. A service principal's effective permissions are its role permissions intersected with the credential's scopes.

In: header

Path Parameters

entity_id*string

Entity id

Formatuuid

Request Body

application/json

The filters to count

TypeScript Definitions

Use the request body type in TypeScript.

POST /entities/{entityId}/records/count request body — the operator's own predicates (same model as query). The base floor + the caller's field access are server-derived, never on the wire.

filter?

Record-browser filter set. Always scoped by org_id + entity_id first (those are path/route inputs, not part of the fingerprint). q is a text-contains search; field_filters are the picked field predicates; ref_filters are single-hop join predicates.

skip_serializing_if on every field keeps an absent filter hashing identically to a never-added one (cursor stability) — join predicates change result-set membership, so they must be part of the fingerprint.

scope?null|

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/records/count" \  -H "Content-Type: application/json" \  -d '{}'

{  "capped": true,  "count": 0}

count_records

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/problem+json

401application/problem+json

403application/problem+json

404application/problem+json

409application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

503application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`