client.secrets.set()

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const secret = await client.secrets.set({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  value: "your-secret-value"
});
console.log(secret);

{
  "name": "example",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const secret = await client.secrets.set({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  value: "your-secret-value"
});
console.log(secret);

{
  "name": "example",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Send value to create or replace the named secret. Returns its name and timestamps without the secret value.

Signature

Method signature on client.secrets:

set(args: {
  projectId: string;
  name: string;
  value: string;
}): Promise<ProjectSecret>;

Parameters

string

required

Project ID with prefix pp..

string

required

The name of a project secret.

string

required

Secret value to store; the API does not return this value.

Returns

Promise<ProjectSecret> Metadata for a project secret. Secret values are never returned.

ProjectSecretName

required

The name of a project secret.

string

required

Time the secret was created, as an ISO 8601 timestamp.

string

required

Time the secret was last updated, as an ISO 8601 timestamp.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
404	Project not found
429	Rate limit exceeded

HTTP endpoint: PUT /projects/{projectId}/secrets/{name}.

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const secret = await client.secrets.set({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  value: "your-secret-value"
});
console.log(secret);

{
  "name": "example",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors