Skip to content

Audit Engagements

An engagement is an auditor reviewing evidence your organisation already holds. The auditor may be external, or one of your own people acting as the auditor. The review is always seen from a mapped framework, such as Cyber Essentials 3.3 or ISO 27001.

An engagement covers one or more frameworks. It pulls in the SCF controls that map to them, and the evidence objects that support those controls. The auditor tests each evidence object on a review board, raises queries, and accepts or sends back the evidence. A dashboard shows how far the audit has got.

Find it in the app under Engagements, in the Admin section of the sidebar. An external auditor who is not a member of your organisation lands on My engagements after signing in, which lists only the engagements they have been granted.

Click + New Engagement and fill in the drawer:

  • Name — how you’ll recognise this audit, e.g. ISO 27001:2022 Certification — FY26.
  • Frameworks — search and tick one or more. Each row shows the framework’s full name, its key, and how many SCF controls map to it. The frameworks you pick decide which controls come into the engagement.
  • Audit period — the start and end of the window evidence is matched against:
    • SOC 2 Type 2 — use the full observation period.
    • ISO 27001 — use the surveillance year.
    • You can leave the dates blank and set them later by editing the engagement.

On save, the engagement fixes its scope: a snapshot of every control mapped to the chosen frameworks, tagged with how your organisation scoped each one. The snapshot is the audit assertion. Evidence and control status stay live, but which controls are in, and why any were excluded, are captured at that moment.

At the same time the engagement creates one review card for every evidence object that maps to an in-scope control. If a control is brought into scope later, its evidence objects get cards the next time the board or dashboard is loaded. Cards are never deleted. A card whose controls all leave scope, or are retired in the catalog, drops off the board.

Each engagement in the list has these actions: Review board, Dashboard, View scope, Present, Auditors and Queries.

The full set of framework-mapped controls, grouped by scope status:

GroupMeaning
In scopeA control your organisation selected
ExcludedA control your organisation put out of scope on purpose. The exclusion justification is shown inline — this is what an auditor reviews to understand why a mapped control was excluded
Not trackedMapped to the framework but not yet in your control set

The controls re-ordered under the chosen framework’s own clause or Annex A identifiers. Switch frameworks with the pills at the top. Each control shows its live implementation status, owner and evidence. Evidence chips are green when the artifact was uploaded inside the audit window and muted when it was not. Nothing is hidden; the auditor decides. Control queries show against their control here.

Manage who can review this engagement. An org admin grants access and chooses the kind:

  • External auditor — someone outside your organisation, picked from your external auditor list. They see this engagement only: its controls, evidence, cards, queries and the shared discussion. Nothing else in your organisation. A member of your organisation cannot be granted as external; grant them as internal.
  • Internal auditor — a member of your organisation acting as the auditor. The person must already be a member, or the grant is refused. See Internal auditors.

Revoking a grant ends access at once. Granting the same person again reactivates their old grant. A grant to an external auditor who has not signed in yet shows as Invited and turns Active at their first sign-in. External grants are revoked automatically the day after the engagement’s end date.

Member invitations are locked to your organisation’s email domain, and that rule is unchanged for viewers, editors and admins. An external auditor is the one exception: invite them from Users → Invite User → Role: External auditor, or from the engagement’s Auditors drawer (Invite a new auditor…).

  • Any company email domain is accepted. Public mail (Gmail, Outlook, iCloud and similar) is refused.
  • They join your organisation’s external auditor list (under Users), not the organisation. They take no seat and see nothing until assigned to an engagement.
  • On the bundled sign-in an account is created and a temporary password is shown once.
  • Someone who is already a member is refused; grant them as an internal auditor.
  • The audit log records the invitation and that the domain rule was exempted for it.

The board is where the audit happens. Open it with Review board on the engagement. There is one tab per framework in the engagement; the clause chips and the clause filter follow the tab.

A card is an evidence object: an entry from the SCF Evidence Request List, such as E-IAC-07. The auditor tests evidence objects, so they are the unit of review. Each card shows:

  • the evidence id and title;
  • the SCF controls it supports, and the clauses of the current framework that those controls map to;
  • the number of files held, and how many of them fall inside the audit window;
  • the number of open queries on it;
  • the AI verdict — the worst existing AI assessment among its in-window files (no new AI call is made);
  • the reviewer (an auditor) and the evidence owner.

How collection is going (files, in-window counts) sits on the card. It is never a column. A card only appears on a framework’s tab when at least one of its controls maps to a clause in that framework.

StageMeaning
OpenNot yet tested by the auditor
In progressThe auditor is testing the evidence
Action requiredThe auditor needs more from the organisation
SubmittedThe organisation has responded and is waiting for the auditor
AcceptedThe auditor accepts the evidence

These are the only moves the system allows. Any other move is refused.

FromToWhoNote
OpenIn progressAuditorNot needed
In progressAction requiredAuditorRequired — tell the organisation what to do
In progressAcceptedAuditorNot needed
Action requiredSubmittedOrg editor or adminRequired — a response note, plus at least one linked file or a reason why there is none
SubmittedIn progressAuditorNot needed
SubmittedAction requiredAuditorRequired
SubmittedAcceptedAuditorNot needed
AcceptedIn progressAuditorRequired — the reason for reopening

“Auditor” means anyone holding an active grant on this engagement, external or internal. An org viewer cannot move cards. A card never goes back to Open.

When the organisation submits, the system also posts the response note and the names of the linked files as a shared comment on the card, so the auditor sees it in the discussion. Files can be linked from those already held for the evidence object, or uploaded from the response form.

Every move is recorded in the card’s History, with who made it, whether they acted as auditor or organisation, and the note. It is also written to the organisation’s audit log.

There are three ways, and all three offer only the moves you are allowed:

  • Buttons in the card panel: Start testing, Action required, Accept evidence, and the Respond to the auditor form for the organisation.
  • Drag and drop between columns. A column that will not take the card does not light up.
  • Move to… on each card, for keyboard use. Arrow keys move through the menu, Enter chooses, Escape closes it.

A move that needs a note opens the card panel with the form ready; finish it there. The board updates at once and goes back if the server refuses. If someone else moved the card after you loaded the board, the move is refused and the message tells you where the card is now. Reload and try again.

Filter by search (evidence id, title, control or clause), clause, SCF control, AI verdict, reviewer (including Unassigned) and Has open queries.

My cards shows the cards where you are the reviewer and, for org members, the cards you own as evidence owner.


A query is a formal question with a status. Use it when an answer is needed and someone has to say when it is settled. It is the audit’s question log.

  • On an evidence object — raised from the card panel’s Queries section. Use it to ask about that evidence, for example for a newer copy of a document.
  • On a control — raised from the No evidence — resolve by query strip above the board, for a control that has no evidence object. The engagement’s Queries action also raises control queries by SCF id.

A query is about exactly one of these, never both. A control query is refused unless the control is in scope for this engagement and not retired.

A query is Open, Answered or Closed.

FromToWhat causes itWho can do it
(new)OpenRaise a queryAnyone with access to the engagement
OpenAnsweredPost an answerAnyone with access to the engagement
AnsweredAnsweredPost another answer (no change)Anyone with access to the engagement
Open or AnsweredClosedClose queryAn auditor with an active grant ¹
AnsweredOpenSet back to Open (API only; the panel has no button for it)Anyone with access to the engagement
ClosedOpenReopen queryAn auditor with an active grant

¹ An internal auditor cannot close a control query when they wrote its latest answer. Another auditor must close it.

The organisation answers; the auditor decides. Only someone with an active auditor grant on the engagement can close a query or reopen a closed one. This matters because closing a control query can mark a control with no evidence object Accepted.

A response to a closed query does not reopen it. The query stays Closed. The panel hides the answer box on a closed query; reopen it first if there is more to say.

A query never changes a card’s stage. If the organisation needs to do something, the auditor must also set the card to Action required with a note. After an auditor raises a query on an evidence object, the panel reminds them of this.

UseWhen
Action requiredThe organisation must act before the evidence can pass, for example supply a newer file. The card moves, the owner is notified, and the organisation must respond with a note and files to move it on
QueryYou need an answer that is tracked to closure, and the card’s stage should not change. Also the only way to resolve a control with no evidence object
Discussion commentConversation: context, a quick clarification, a mention of a colleague. No status and nothing to close

Some in-scope controls have no evidence object mapped to them in the catalog. They have no card. They are listed in the strip above the board and on the dashboard.

Such a control is Open until it is resolved by a control-level query. It counts as Accepted once it has at least one Closed control-level query and none that are Open or Answered. Raising a new query, or reopening a closed one, puts it back to Open. That status then rolls up to the control’s clauses like any other control.

A control that does have evidence objects ignores its control-level queries for its status; its status comes from its cards only.

The auditor is testing E-NET-04 (Network Security Controls). The only firewall rule review held is from before the audit window.

  1. The auditor opens the card and clicks Start testing. The card moves to In progress.
  2. The auditor raises a query on the card: “Is there a firewall rule review from inside the audit period?” The evidence owner is notified. The card stays In progress.
  3. The owner answers: “Yes, March’s review. Uploading it now.” The query is Answered.
  4. The auditor wants the file before testing further, so moves the card to Action required with the note “Upload the March firewall review.” The owner is notified.
  5. The owner opens the card, uploads the March file in Respond to the auditor, writes a note and submits. The card is Submitted and the reviewer is notified.
  6. The auditor checks the file, closes the query and clicks Accept evidence.

If step 4 had been skipped, the card would have stayed In progress with an Answered query, and nothing would have asked the owner to upload anything.

Worked example 2: a control with no evidence object

Section titled “Worked example 2: a control with no evidence object”

Say control GOV-02 maps to a Cyber Essentials clause but no evidence object maps to it.

  1. On the board the auditor opens GOV-02 in the No evidence strip and raises a query: “How is this policy published to staff?” Org admins are notified. The control is Open.
  2. An org admin answers with a link to the intranet page. The query is Answered. The control is still Open.
  3. The auditor is satisfied and closes the query. The control now counts as Accepted on the dashboard, and so do its clauses if their other controls are Accepted.
  4. If the auditor later reopens the query, the control is Open again.

Each card has a discussion thread with replies, @mentions, edits and soft delete.

  • Shared comments are seen by everyone with access to the engagement, auditors included. This is the default.
  • Internal notes are for the organisation only, and are marked Organisation only — not visible to the auditor.

A reply takes its parent’s visibility. You can mention only people with access to the engagement; in an internal note, only org members who hold no auditor grant. A mention notifies that person.

You can edit and delete your own comments. Edits keep the earlier version in the comment’s history. An org admin, acting as the organisation, can delete anyone’s comment.


Evidence owner. Each card shows who owns the evidence for the organisation. It comes from the organisation’s evidence tracking for that evidence id: the assigned person, then the accountable team (its primary and delegate), then the org admins. If your organisation does not track that evidence id, the card shows Unowned → org admins. Evidence is owned by a team, not assigned to a person, so an org admin sets the card’s Accountable team from the panel (the same team assignment as on the evidence screens). If a person was assigned to the evidence before team ownership, the admin can clear them and hand the evidence back to its team; a new person cannot be assigned. Auditors cannot change the owner.

Reviewer. The auditor reviewing a card. An auditor or an org admin can assign or clear it. The reviewer must hold an active auditor grant on the engagement.

Notifications. Each of these appears in the bell and is emailed, subject to the person’s notification preferences. Messages show people’s names, never their email addresses.

EventWho is notified
Card moved to Action requiredThe evidence owner (owner chain above), and the accountable team’s primary and delegate as well, even when a person is assigned. Not the auditor who moved it
Card moved to SubmittedThe assigned reviewer, if they still hold an active grant; otherwise every active auditor on the engagement
Reviewer assignedThe new reviewer
Query raised on an evidence objectThe evidence owner. Not the person who raised it
Query raised on a controlOrg admins. Not the person who raised it
Query answeredThe person who raised it, unless they wrote the answer, and only while they still have access to the engagement
Query closed or reopenedNobody — check the query list
Mention in a commentThe people mentioned, except the author

External auditors receive these notifications too, limited to their engagement. Clicking one opens the card.


An internal auditor is an org member given an auditor grant of kind internal. They can make every auditor move on the board.

They are also an org member, so as an editor or admin they can respond for the organisation. Segregation of duties stops them accepting evidence where they are not independent. An internal auditor cannot accept an evidence object when:

  1. they own it (they are the assigned person or the owner on its tracking record);
  2. they are on a team accountable for it; or
  3. they made the latest organisation response on it (they moved it to Submitted).

The board does not offer Accept in those cases, and the server refuses it with a message giving the reason. Another auditor must accept it. External auditors are never blocked by this rule.


Open it with Dashboard on the engagement. It shows one framework at a time. Every number comes from the server.

ItemMeaning
Evidence acceptedCards in Accepted, out of all cards on this framework’s tab
Clauses acceptedClauses whose rolled-up status is Accepted, as a share of the framework’s clauses
Controls acceptedIn-scope controls with a clause in this framework whose rolled-up status is Accepted
Action requiredCards in Action required
Open queriesQueries in Open status, on evidence objects on this tab plus on this tab’s controls. Answered queries are not counted
Stacked barsEvidence, controls and clauses by stage
Clause gridEach clause’s rolled-up status, grouped by the first part of its id
Evidence needing the organisationCards in Action required, with the controls and clauses each one holds back. Click one to open it on the board
Controls with no evidence objectResolved by control-level query; see above
TimelineAudit window opens and closes (from the engagement dates); testing started (first card move); all evidence tested (no card left in Open or In progress); all clauses accepted

The same rule turns a control’s cards into a control status, and a clause’s controls into a clause status:

  1. Any item in Action required → Action required.
  2. Otherwise, all items Accepted → Accepted.
  3. Otherwise, all items Submitted or Accepted → Submitted.
  4. Otherwise, any item past Open → In progress.
  5. Otherwise → Open.

So one evidence object in Action required holds its control in Action required, and that control holds its clauses there too.


ActionOrg viewerOrg editorOrg adminExternal auditorInternal auditor
Create or edit an engagement✓✓
Delete a draft engagement✓
View scope, Present, board, dashboard✓✓✓✓✓
List auditors✓✓✓✓ ¹
Grant or revoke auditors✓✓ ¹
Auditor moves on the board✓✓ ²
Submit the organisation’s response✓✓✓ ¹
Assign a reviewer✓✓✓
Set the accountable team✓
Raise or answer queries✓✓✓✓✓
Close or reopen queries✓✓ ³
Shared comments✓✓✓✓✓
See and write internal notes✓✓✓
Delete anyone’s comment✓

¹ Through their org role: an internal auditor is also an org member and keeps the rights of that role. ² Except Accept where segregation of duties applies. ³ Except closing a control query whose latest answer they wrote.

Only a draft engagement can be deleted.


Every route is under /api and needs a bearer token. Below, {base} stands for /api/organizations/{org_id}/engagements/{engagement_id}.

“Engagement access” means an org member (viewer or higher) or the holder of an active auditor grant on this engagement. Without it every engagement route returns 404, never 403, so a stranger cannot tell whether the engagement exists.

Errors: 404 not found or no access; 403 signed in with access but not allowed this action; 409 the move is not allowed from the current state, or the record changed; 422 a required field or note is missing or invalid; 400 an unknown value.

MethodPathWhoWhat it does
GET/api/organizations/{org_id}/engagementsOrg viewer+List engagements (?status=)
POST/api/organizations/{org_id}/engagementsOrg editor+Create; fixes scope and creates cards
GET{base}Engagement accessOne engagement
PATCH{base}Org editor+Update name, frameworks, status, dates
DELETE{base}Org adminDelete a draft engagement (409 if not draft)
GET{base}/scopeEngagement accessFixed scope with badges
GET{base}/presentation?framework=Engagement accessControls under the framework’s clauses
GET{base}/auditorsOrg viewer+List auditor grants
POST{base}/auditorsOrg adminGrant {user_id, kind}; kind is external (default) or internal (422 if not a member)
DELETE{base}/auditors/{auditor_id}Org adminRevoke a grant
GET/api/my-engagementsSigned-in userEngagements where you hold an active grant
MethodPathWhoWhat it does
GET{base}/evidence-reviewsEngagement accessThe board for one framework: cards, no-evidence controls, counts, filter options and what you may do. Query: framework, status, clause, scf_id, ai_verdict, has_open_queries, reviewer (user id or none), search, mine
GET{base}/evidence-reviews/{evidence_id}Engagement accessOne card with its files, last decision and catalog text
POST{base}/evidence-reviews/{evidence_id}/statusPer the move tableMove a card. Body: to_status, optional from_status, note, artifact_file_ids, no_artifact_reason
PUT{base}/evidence-reviews/{evidence_id}/reviewerAuditor or org adminAssign {user_id} or clear (null) the reviewer
GET{base}/evidence-reviews/{evidence_id}/eventsEngagement accessThe card’s history, oldest first
GET{base}/evidence-reviews/{evidence_id}/files/{file_id}Engagement accessA signed download link for one file
GET{base}/review-peopleEngagement accessActive auditors and org members, names only
GET{base}/review-dashboard?framework=Engagement accessThe dashboard roll-up

Send from_status with the stage you saw. If the card has moved since, the request fails with 409 and nothing changes. Leave it out to skip the check.

MethodPathWhoWhat it does
GET{base}/queriesEngagement accessList queries. Query: scf_id, evidence_id, status
POST{base}/queriesEngagement accessRaise. Body: title, body, and exactly one of scf_id or evidence_id. Does not move the card
GET{base}/queries/{query_id}Engagement accessOne query with its responses
POST{base}/queries/{query_id}/responsesEngagement accessAnswer {content}. Open → Answered; a closed query stays Closed
PATCH{base}/queries/{query_id}Close or reopen: active auditor grantSet {status}: close, reopen, or answered → open

Paths are under {base}/evidence-reviews/{evidence_id}/comments.

MethodPathWhoWhat it does
GET?visibility=shared or ?visibility=internalEngagement access; internal only for org members without a grantThe thread, oldest first
GET/countsEngagement accessshared, plus internal only for those who may see it
POST(none)Engagement accessPost {content, visibility, parent_comment_id, mentions}
PATCH/{comment_id}AuthorEdit; keeps the old version
DELETE/{comment_id}Author, or org admin without a grantSoft delete
GET/{comment_id}/historyEngagement accessEarlier versions, newest first

An internal note is a 404 to an auditor on every route above, exactly as if it did not exist.

The SCF MCP server has tools for engagements, scope, presentation, auditors and control queries. It does not yet cover queries on an evidence object, the kind of an auditor grant (every grant it makes is external), the review board, card moves, reviewers, card history, the dashboard or the discussion. For those, use the web app or the API.


  • Evidence window uses the file’s upload date as a stand-in for when the evidence is from. This suits ISO’s last-period framing; a separate effective date per file, for SOC 2 Type 2, is planned.
  • Clause groups on the dashboard are labelled by the first part of the clause id (for example A, CC3, or 3 for Cyber Essentials 3-BP4). The catalog holds clause ids only, with no section names.
  • Framework outline comes from the controls that map to the framework, so a clause no control maps to does not appear.
  • Retired controls drop out of an engagement’s board and dashboard, even if they were in scope when it was created.
  • Queries: closing and reopening send no notification.
  • Download links for evidence files are valid for 15 minutes once issued, including after the auditor’s grant is revoked.
  • Framework and control pickers take identifiers directly; friendlier pickers are planned.