Skip to main content

toolRecord

Retrieves a single JSON record previously persisted via the Tools API.

This is the lightweight read path for incubator features that already use upsertToolRecord to persist state.

Business Rules​

  • The record must belong to the caller's company
  • Archived records are still readable by ID

Error Scenarios​

  • **NOT_FOUND**: when the record does not exist
  • **FORBIDDEN**: when caller lacks tools:read_record

Permissions Required​

  • tools:read_record
toolRecord(
  id: ID!
): ToolRecord!

Arguments​

toolRecord.id ● ID! non-null scalar common​

The UUID of the persisted tool record.

Type​

ToolRecord object common​

A single tenant-scoped JSON record persisted via the Tools API. Each record belongs to a collection (a stable namespace) and carries a payload plus optional metadata.