Anchorage API reference
    Preparing search index...

    Interface ApprovalRecord

    interface ApprovalRecord {
        claimedAt?: string;
        claimedBy?: string;
        comment?: string;
        connectors: string[];
        createdAt: string;
        decidedAt?: string;
        decidedBy?: string;
        decision?: ApprovalDecision;
        delegatedTo?: string;
        escalatedAt?: string;
        grantScope?: ApprovalGrantScope;
        id: string;
        payload?: unknown;
        priority: ApprovalPriority;
        requestedBy?: string;
        requestedByKind?: "human" | "service" | "agent" | "system";
        resumeCount?: number;
        resumedAt?: number;
        resumeTarget?: ApprovalResumeTarget;
        runId: string;
        runScoped?: boolean;
        slaDeadlineAt?: string;
        status: ApprovalStatus;
        stepPath?: string[];
        summary?: string;
        suspendedAt?: number;
        title: string;
        toolCallId?: string;
        updatedAt: string;
        workflowId: string;
    }
    Index

    Properties

    claimedAt? claimedBy? comment? connectors createdAt decidedAt? decidedBy? decision? delegatedTo? escalatedAt? grantScope? id payload? priority requestedBy? requestedByKind? resumeCount? resumedAt? resumeTarget? runId runScoped? slaDeadlineAt? status stepPath? summary? suspendedAt? title toolCallId? updatedAt workflowId

    Properties

    claimedAt?: string
    claimedBy?: string
    comment?: string
    connectors: string[]

    Connector ids an approval grants (breakwater write gate). Recorded at creation by trusted server-side code — the grant provider derives requestContext grants from these on approved records only.

    createdAt: string
    decidedAt?: string
    decidedBy?: string
    decision?: ApprovalDecision
    delegatedTo?: string

    Latest delegation target (also reflected in claimedBy).

    escalatedAt?: string
    grantScope?: ApprovalGrantScope

    Explicit effective capability scope. Missing on capability-free records and legacy rows; grant derivation treats absence as inert.

    id: string
    payload?: unknown

    Workflow-provided reviewer context (typically the suspend payload).

    priority: ApprovalPriority
    requestedBy?: string
    requestedByKind?: "human" | "service" | "agent" | "system"

    Principal kind paired with requestedBy. Missing only on legacy rows and treated as human by separation-of-duties checks (fail closed).

    resumeCount?: number

    Runtime-owned monotonic resume ordinal of that suspension — undefined for a step's FIRST suspension, 1,2,… on successive re-suspensions. Pairs with suspendedAt in the exact grant binding as the collision-free tie-breaker: unlike resumedAt the runtime increments it on every resume regardless of payload, so two same-step suspensions stay distinguishable even when their suspendedAt collide within a millisecond.

    resumedAt?: number

    Epoch-ms resumedAt of that suspension (core clock). INFORMATIONAL audit metadata only — Mastra stamps it solely on a payload-bearing resume, so it is NOT the grant tie-breaker (that is resumeCount).

    resumeTarget?: ApprovalResumeTarget

    Server-authored resume topology. Never accepted from the HTTP create body.

    runId: string
    runScoped?: boolean

    Explicit run-scoped standing grant: a step-less record mints its connectors on EVERY leg of the run. Opt-in only — a step-less record WITHOUT this flag mints nothing, because "absent field => maximal privilege" is an inverted default. Suspend-observation bridges must never set this (they always carry a stepPath); only trusted code that deliberately wants a run-wide capability does.

    slaDeadlineAt?: string
    status: ApprovalStatus
    stepPath?: string[]

    Suspended step path this approval unblocks, e.g. ['approval'].

    summary?: string
    suspendedAt?: number

    Epoch-ms suspendedAt of the suspension this approval binds to (core clock) — see CreateApprovalInput.suspendedAt. Grant minting requires an EXACT match with the resumed leg's suspension timestamp when present, paired with resumeCount.

    title: string
    toolCallId?: string

    Mastra tool-call identity for a tool-call scoped grant.

    updatedAt: string
    workflowId: string

    Settings

    Member Visibility

    On This Page

    Properties