Youdo Business

---

name: youdo-business description: Work with the YouDo Business API. Use when asked to interact with YouDo Business to manage employees, projects, tasks, payments, webhooks, or generate signed API requests.

---

YouDo Business API Skill

This skill provides the knowledge and guidelines for interacting with the YouDo Business API.

Base URLs

Production: https://business-api.youdo.com/api/v1

Sandbox/Test: https://business-api.public-test.youdo.sg/api/v1

Swagger: https://business-api.youdo.com/api/doc/index.html

Authentication

All requests use JSON Web Token (JWT) signed with the RS256 asymmetric algorithm.

The JWT must be sent in the header: Authorization: Bearer

Header: {"alg": "RS256", "typ": "JWT", "kid": ""}

Payload: {"iss": "", "cid": ""}

Request Signing

Certain methods (like /api/v1/Task/{taskId}/pay) require request signing. You must include the following headers:

Date: Current time, RFC 7231 (e.g., Tue, 19 Feb 2019 08:43:02 GMT)

Content-SHA256: SHA256 hex hash of the request body (empty string for GET).

Signature: RS256 signed hex string of the request string.

String to Sign format:

Uppercase(RequestMethod) + "\n"
RequestPath + "\n"
RequestQuery + "\n"  // Alphabetically sorted, URLEncoded
SignedRequestHeaders + "\n" // Alphabetically sorted, lowercased keys
SHA256Hex(RequestPayload)

Key Endpoints

Employees (Исполнители)

Create: POST /Employee

- Body: phone, firstName, lastName, inn, projectId

Get Info: GET /Employee/{id}

Search: POST /Employe/search (Body: projectIds, employeeName, inns, phones, itemsPerPage, page)

Find by Phone: GET /Employe/byPhone/{phone}

Add to Project: POST /Employee/addToProject

Remove from Project: DELETE /Employee/{id}/deleteFromProject/{projectId}

Restart Binding: PUT /Employee/{id}/binding/restart

Projects (Проекты)

Get Projects: GET /Project/Projects

Tasks & Payments (Задания и выплаты)

Create Internal Task: POST /Task/internal

Create External Task: POST /Task/external

Get Task: GET /Task/{taskId}

Update Task: PUT /Task/{taskId}

Pay Task: POST /Task/{taskId}/pay (Requires request signing)

Resend Offer: PUT /Task/{taskId}/resendOffer

Documents (Документы)

Download Doc: GET /Documents/{documentId}

Download Cert: GET /Documents/{documentId}/certificate

Payments Report (Отчет агента)

List Payments: POST /Payments (Body: from, to, inn, taskIds, ids)

Framework Agreements (Рамочные соглашения)

Get Agreements: GET /FrameworkAgreements/employees/{employeeId}/projects/{projectId}

Create: POST /FrameworkAgreements

Stop: POST /FrameworkAgreements/{agreementId}/stop

Prepayment Invoices (Счета на предоплату)

Create: POST /prepaymentInvoices (Body: companyId, amount)

Get: GET /prepaymentInvoices/{id}

Balance (Баланс)

By Company: GET /Balance/byCompany?companyId={id}

By Project: GET /Balance/byProject?projectId={id}

Webhooks

Subscribe: POST /WebHook/subscribe (Body: type, url, headers)

Unsubscribe: DELETE /WebHook/{type}/unsubscribe