← Docs

Docs · Connector reference

Secureframe connector reference

Operations, inputs, troubleshooting, and questions for the Secureframe connection.

Set up and verify the Secureframe connection

  1. Choose one task and its account, and match the reads and actions on the overview page to it before granting provider permissions.
  2. Prepare the connection settings from the overview page, connect the provider in Deixic, and choose which tools your agent can use.
  3. Try a small task with a known result, and compare the returned identity and resource with what the account owner expects.
  4. Review the retrieved information, retain its identifiers, and keep any later change in a separate, explicitly authorized step.

Information your agent can use

ResourceRecord identityStart withPage coverage
ControlsidTop levelCursor
FindingsidTop levelCursor
UsersidTop levelCursor
Record identity
Match on these fields before joining or deduplicating results; where none is specified, check the returned record first.
Start with
Resolve the parent identifier first.
Cursor
Cursor pagination. Continue from the returned cursor; an initial page is not a complete inventory.

Supported operations

Review the inputs before granting an action to an agent. Required inputs must be supplied, optional inputs narrow the request, and provider permissions apply in addition to Deixic policy.

Read
Retrieves information; check the returned scope and identifiers before use.
OperationEffectApprovalProvider permissionsInputs
Test ListReadBy policyNone named4
Test GetReadBy policyNone named1
Device ListReadBy policyNone named3

Inputs by operation

Test List Read
Inputs for Secureframe Test List
InputRequirementAccepted value
pageOptionalintegerMinimum: 1Maximum: 100000
per_pageOptionalintegerMinimum: 1Maximum: 100
qOptionalstringMinimum characters: 1Maximum characters: 512
sortOptionalstringMinimum characters: 1Maximum characters: 64
Test Get Read
Inputs for Secureframe Test Get
InputRequirementAccepted value
test_idRequiredstringMinimum characters: 1Maximum characters: 128
Device List Read
Inputs for Secureframe Device List
InputRequirementAccepted value
pageOptionalintegerMinimum: 1Maximum: 100000
per_pageOptionalintegerMinimum: 1Maximum: 100
qOptionalstringMinimum characters: 1Maximum characters: 512

When the Secureframe task does not produce the expected result

Connected, but the expected data is missing

Check the identity behind the bearer token connection and its access to the specific resource; a successful connection does not establish access to every object.

Compare the lookup against one known record first, and keep an empty response separate from a permissions error.

The answer covers only part of the data

Check the resource’s page coverage, query filters, and result limit, and have the agent state the account and time window it inspected, so a partial response yields a scoped answer.

The agent keeps doing the same work

Inspect the action history for repeated targets and inputs, keep the successful result’s identifiers with the task, and refresh a lookup only when the information changed.

Questions about the Secureframe connector

Can I use my existing agent with Secureframe?

Yes: connect your agent to Deixic through MCP, choose which connected tools it can use, and Deixic checks calls routed through its gateway; Dex is available if your team also wants an agent.

Can an agent change data in Secureframe?

This connector supports reads. Use a configured connection to retrieve information and prepare a recommendation; it provides no action for changing provider data, even if the provider’s API offers writes.

What do I need to connect Secureframe?

Prepare token; the connection uses Bearer token, and the connected identity’s provider permissions determine which resources it can access.

Does connecting Secureframe keep every answer up to date?

No: an earlier answer is still an earlier answer, so for a decision that depends on current state, have the agent refresh the source and retain the lookup time, and save stable instructions separately from facts that can change.