Get entity completion-floor coverage

View as Markdown

Evaluates one entity against the mandatory completion floor using the already-assembled entity detail. Each slot reports present/count and how to obtain the gate when absent. Slots not derivable from the assembled detail report present=false with a direct read hint. Use includePrivate=true (privileged callers) to evaluate hidden or unpublished entities.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

OR
X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Path parameters

entityIdstringRequiredformat: "uuid"
Canonical entity UUID.

Query parameters

includePrivatebooleanOptional

Privileged read scope; evaluate hidden/unpublished entities. Requires trusted credentials. Defaults to private for admin callers, public otherwise.

Response

OK
entityIdstringformat: "uuid"
Canonical entity UUID this coverage describes.
slotlist of objects

One coverage row per evaluated gate: flat entity-level gates, plus one indexed row per associated person or Product/Service child for gates that repeat by parent.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error