Secure file sharing
Plan projects, track progress and share updates without another status meeting. Friendly people answer your questions quickly, by phone, chat or email.
Overview
Clear reports turn weekly numbers into decisions in minutes, not days. Thousands of customers already trust us, and we work hard to keep it that way. Our open API and ready-made integrations fit into the stack you already have.
Installation
Install the SDK with the package manager your project already uses. It needs Node 18 or newer.
$ npm install @yaraly-works/sdk$ yarn add @yaraly-works/sdk$ pnpm add @yaraly-works/sdkConfiguration
Onboarding guides and live chat help new colleagues get going on day one. Automations take care of the repetitive steps, so people can focus on real work. Create a file named yaraly-works.config.json in the project root:
{
"project": "yaraly-works",
"region": "us-east",
"categories": ["product", "engineering", "marketing"],
"retries": 2,
"timeoutMs": 9000,
"webhooks": { "enabled": true }
}| Option | Type | Default | Description |
|---|---|---|---|
project | string | - | Your project key from the dashboard. |
region | string | "us-east" | Data centre closest to your customers. |
retries | number | 3 | How often a failed call is retried. |
timeoutMs | number | 10000 | Time before a request is cancelled. |
webhooks.enabled | boolean | false | Send events to your endpoint. |
Your first request
Your data is encrypted, backed up daily and hosted in the region you choose.
- Create an API keyOpen the dashboard, choose Settings › API keys and copy a new secret key.
- Store it safelyKeep the key in an environment variable, never in your source code.
- Make the callRun the snippet below; it prints the first page of results.
import { Client } from "@yaraly-works/sdk";
const client = new Client({ apiKey: process.env.API_KEY });
// list the newest plans in one category
const page = await client.plans.list({ category: "product", limit: 20 });
for (const item of page.data) {
console.log(item.name, item.price);
}API reference
Every endpoint returns JSON and uses standard HTTP status codes.
/v1/plansList plans with paging and filters./v1/plansCreate a new plan./v1/plans/{id}Update some fields of a plan./v1/plans/{id}Archive a plan; it can be restored for 30 days.{
"data": [
{ "id": "plan_9765", "name": "Analytics add-on", "price": 178 }
],
"has_more": true
}Troubleshooting
Next steps
Every detail is handled by people who care about getting it right.