Make a client - Sumvin

Private preview: this is rolling out and may not be available on your account yet.

Every call goes through a client you create once with createSumvinClient. Each operation takes that client as { client }.

import { createSumvinClient, listAgentIdentities } from "@sumvin/sdk";

const client = createSumvinClient({
  baseUrl: "https://api.sumvin.com",
  auth: [/* see Sign in */],
});

const { data, error } = await listAgentIdentities({ client });

Options

Option	Required	What it does
`baseUrl`	Yes	The API address.
`auth`	No	How requests authenticate. Leave it out for an unauthenticated client. See Sign in.
`fetch`	No	Your own `fetch`, for proxies or runtimes where you don’t want the global one.
`headers`	No	Headers added to every request.
`validation`	No	Response validation settings. Validation is on by default.
`timeoutMs`	No	A per-request timeout, in milliseconds. No timeout by default.

What a call returns

Each operation returns { data, error }. Check error before you use data, or pass the result to unwrap, which returns data or throws. See Errors.

import { unwrap } from "@sumvin/sdk";

const identities = unwrap(await listAgentIdentities({ client }));