Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Dock Certs

Scalekit connector
Open markdown

The Dock Certs connector lets your AI agent act in each user's Dock Certs account. Each user connects their own Dock Certs access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

Tools
59
What they doRead · write · destructive
28 · 21 · 1028 read21 write10 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Dock Certs connection

    In AgentKit > Connections, create a Dock Certs connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'dockcerts'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Dock Certs:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'dockcerts_account_profile_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Dock Certs credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • dockcerts_account_profile_getGet the Truvera account profile of the API key's owner.Read-only

    Get Account Profile

    Get the Truvera account profile of the API key's owner. Returns the account's name, email, plan and settings. Use it to confirm which account the connection uses.

    Inputs

    This tool takes no inputs.

  • dockcerts_account_stats_getGet usage statistics for the account.Read-only

    Get Account Stats

    Get usage statistics for the account. Returns counts such as credentials issued, DIDs, schemas and verifications. Use it for usage reporting.

    Inputs

    This tool takes no inputs.

  • dockcerts_credential_getGet one issued credential's metadata, and its contents if it was persisted.Read-only

    Get Credential

    Get one issued credential's metadata, and its contents if it was persisted. Returns the credential id, type, issuer, subject reference, revocation info and, for persisted credentials, the credential JSON. Use credentials_list to find credential IDs.

    Inputs

    credential_idstringrequired
    Full ID of the credential, a URI such as https://creds.truvera.io/5c2b1e9a..., URL-encoded because it is placed in the URL path (encode : as %3A and / as %2F). Get it from credentials_list or credential_issue. Example: https%3A%2F%2Fcreds.truvera.io%2F5c2b1e9a8f7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f4e3d.
    passwordstring
    Deprecated. Supplying this parameter to retrieve decrypted persisted credential contents is deprecated and should not be used. Refer to the cloud wallet documentation for the recommended approach. Example: my-strong-passphrase.
  • dockcerts_credential_verifyVerify a verifiable credential or presentation, given as JSON (or a JWT string inside a JSON string).Read-only

    Verify Credential

    Verify a verifiable credential or presentation, given as JSON (or a JWT string inside a JSON string). Returns verified true or false and the results of each check. Use it to check a credential a holder has shared.

    Inputs

    credentialobjectrequired
    The verifiable credential or presentation JSON to verify, as issued (with its proof). Send the whole object. Example: {"@context": ["https://www.w3.org/2018/credentials/v1"], "type": ["VerifiableCredential"], "issuer": "did:cheqd:mainnet:ac2b9027-ec1a-4ee2-aad1-2f4a7e5b3c11"...
  • dockcerts_credentials_listList the credentials your account has issued, with paging and an optional filter.Read-only

    List Credentials

    List the credentials your account has issued, with paging and an optional filter. Returns each credential's id, type, subject reference, issuer, revocation and creation dates. Use credential_get for one credential.

    Inputs

    filterstring
    Filter by specific Credential ID, Subject Ref, Subject ID, Issuer, Type, Created Date or Issue Date. Example: AlumniCredential.
    limitinteger
    How many items to return at one time (max 100). Defaults to 64. Example: 64.
    offsetinteger
    How many items to offset by for pagination. Defaults to 0. Example: 0.
    subject_idstring
    Filter credentials by an exact credential subject ID (holder DID). Useful for finding all credentials issued to a specific holder. Example: did:key:z6MkqBcwvYurNSSqyBkxavv4fkaq2iu3v3YGMbdyfa4bVNxD.
  • dockcerts_did_getResolve one DID.Read-only

    Get DID

    Resolve one DID. Returns its DID document with verification methods, controller and service endpoints. Use dids_list to see your DIDs.

    Inputs

    didstringrequired
    A DID. Example: did:cheqd:mainnet:ac2b9027-ec1a-4ee2-aad1-2f4a7e5b3c11.
  • dockcerts_dids_listList the DIDs your account controls.Read-only

    List DIDs

    List the DIDs your account controls. Returns each DID's fully resolved DID document. Use did_get for one DID.

    Inputs

    limitinteger
    How many items to return at one time (max 64). Defaults to 64. Example: 64.
    offsetinteger
    How many items to offset by for pagination. Defaults to 0. Example: 0.
    typestring
    The type of DID for filtering. Example: cheqd.
  • dockcerts_job_getGet the status of an asynchronous blockchain job, such as a DID creation or a revocation.Read-only

    Get Job

    Get the status of an asynchronous blockchain job, such as a DID creation or a revocation. Returns the job id, status (todo, in_progress, finalized or error) and its result. Poll it after tools that return a job id.

    Inputs

    job_idstringrequired
    A Job id. Example: 1234.