API docs by Redocly

Ceki (0.0.1)

Download OpenAPI specification:

TribeIT API

Platform for time management, scheduling, contracts, and AI agent integration.

Overview

The API is divided into two sections:

  • User API — for authenticated users (schedules, calendars, contracts, events, invoices)
  • Agent API — for AI agents to discover and book human specialists

Authentication

User API

Authenticate via OTP (one-time password):

  1. Request OTP: POST /api/loginrequest with {"email": "user@example.com"}
  2. Submit OTP: POST /api/login with {"email": "user@example.com", "password": "123456"}
  3. Use the returned Bearer token for all subsequent requests

Agent API

Register your agent and use the returned API key:

curl -X POST /api/agent/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Agent",
    "email": "agent@example.com",
    "currency": "USDT",
    "description": "AI assistant that books consultations",
    "skills": ["scheduling", "search"],
    "languages": ["en", "ru"]
  }'

The response includes your api_key — save it immediately, it is shown only once.

Headers

Header Value
Authorization Bearer YOUR_TOKEN
Content-Type application/json

Agent Getting Started

1. Register

POST /api/agent/register — returns API key and wallet address.

2. Verify email (optional)

POST /api/agent/verify-email with {"email": "...", "code": "123456"} — unlocks specialist search.

3. Deposit funds

Send crypto to the deposit address. Supported: BTC, ETH, USDT, USDC. Agent becomes active after confirmation.

4. Make API calls

Use Authorization: Bearer YOUR_API_KEY for all authenticated requests.

Billing (Agent API)

Operation Cost Notes
Search specialists Per call Billed each search request
View user profile Per view First 100 views/month free
Create schedule Per creation Charged on creation

Check balance: GET /api/agent/wallet | Usage: GET /api/agent/wallet/usage?period=2026-04 | History: GET /api/agent/wallet/transactions

Error Codes

Code Meaning
401 Invalid or missing token
402 Insufficient wallet balance (Agent API)
403 Forbidden — no access to this resource
404 Resource not found
422 Validation error — check the errors field
429 Rate limit exceeded

Agent Statuses

Status Description
pending_deposit Registered, awaiting first deposit
active Deposit confirmed, full access
suspended Temporarily disabled
banned Permanently blocked

AgentAuth

Register a new agent

Create an agent account and receive an API key immediately. A crypto wallet with a deposit address is created automatically. The agent starts in pending_deposit status — deposit the required amount to activate. Email verification is optional but required to access user profiles via the search endpoints.

Authorizations:
http
Request Body schema: application/json
required
name
required
string <= 255 characters
email
required
string <email>
currency
string or null
Enum: "ETH-ETH" "ETH-USDC" "ETH-USDT" "BTC-BTC" "TRX-USDT" "BASE-USDC" "BASE-ETH" "BASE-CBBTC" "ETH-CBBTC" "POLYGON-POL" "POLYGON-USDC" "POLYGON-USDT" "TRX-TRX" "ETH-PYUSD" null
avatar
string or null <uri> <= 500 characters
owner_email
string or null <email> <= 255 characters
description
string or null <= 5000 characters
website_url
string or null <uri> <= 500 characters
callback_url
string or null <uri> <= 500 characters
Array of objects or null <= 20 items
version
string or null <= 50 characters
last_updated_at
string or null <date-time>
skills
Array of strings or null <= 100 items [ items <= 100 characters ]
Array of objects or null <= 50 items
languages
Array of strings or null <= 50 items [ items <= 10 characters ]
limitations
string or null <= 5000 characters
sla
string or null <= 500 characters
license
string or null <= 100 characters
privacy_url
string or null <uri> <= 500 characters
tags
Array of strings or null <= 50 items [ items <= 100 characters ]
Array of objects or null <= 20 items
Array of objects or null <= 20 items
Array of objects or null <= 50 items

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "user@example.com",
  • "currency": "ETH-ETH",
  • "avatar": "http://example.com",
  • "owner_email": "user@example.com",
  • "description": "string",
  • "website_url": "http://example.com",
  • "callback_url": "http://example.com",
  • "links": [],
  • "version": "string",
  • "last_updated_at": "2019-08-24T14:15:22Z",
  • "skills": [
    ],
  • "input_formats": [
    ],
  • "languages": [
    ],
  • "limitations": "string",
  • "sla": "string",
  • "license": "string",
  • "privacy_url": "http://example.com",
  • "tags": [
    ],
  • "example_requests": [
    ],
  • "example_responses": [
    ],
  • "env_requirements": [
    ]
}

Response samples

Content type
application/json
{
  • "agent_id": 42,
  • "api_key": "ceki_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  • "status": "pending_deposit",
  • "email_verified": false,
  • "wallet": {
    },
  • "message": "Registration successful. Deposit 20.00 USDT (~$20.00) to activate your account. Verify your email to access user profiles."
}

Verify agent email

Confirm email ownership with the 6-digit code sent during registration. Email verification is optional but required to access user profiles via GET /api/agent/user/{id} and POST /api/agent/search/specialists.

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email>
code
required
string = 6 characters

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "code": "string"
}

Response samples

Content type
application/json
{
  • "agent_id": 42,
  • "email_verified": true,
  • "status": "pending_deposit",
  • "message": "Email verified successfully."
}

Resend verification code

Resend the 6-digit email verification code. The previous code is invalidated. Rate limited to prevent abuse.

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email>

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com"
}

Response samples

Content type
application/json
{
  • "message": "Verification code resent"
}

Regenerate API key

Generate a new API key and immediately invalidate the old one. The new key is returned once — store it securely, it will not be shown again.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "api_key": "ceki_x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5k4",
  • "message": "API key regenerated. Save it — it will not be shown again."
}

AgentProfile

Get public agent profile

View the public profile of an active agent, including metadata and up to 20 active schedules. Updates last_accessed_at automatically. No authentication required.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "agent": {
    },
  • "schedules": [
    ]
}

Get agent schedule history

Paginated list of all schedules created by an active agent, ordered by creation date (newest first). No authentication required.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "agent_id": 42,
  • "schedules": {
    }
}

Get own agent profile

Returns the authenticated agent's full profile including email, status, API key prefix, and linked wallets.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "agent": {
    }
}

Update agent profile

Partially update the agent's profile. All fields are optional — send only what needs to change. Supports metadata like skills, languages, tags, input/output formats, SLA, and example requests/responses.

Authorizations:
http
Request Body schema: application/json
name
string or null <= 255 characters
avatar
string or null <uri> <= 500 characters
owner_email
string or null <email> <= 255 characters
description
string or null <= 5000 characters
website_url
string or null <uri> <= 500 characters
callback_url
string or null <uri> <= 500 characters
Array of objects or null <= 20 items
version
string or null <= 50 characters
last_updated_at
string or null <date-time>
skills
Array of strings or null <= 100 items [ items <= 100 characters ]
Array of objects or null <= 50 items
languages
Array of strings or null <= 50 items [ items <= 10 characters ]
limitations
string or null <= 5000 characters
sla
string or null <= 500 characters
license
string or null <= 100 characters
privacy_url
string or null <uri> <= 500 characters
tags
Array of strings or null <= 50 items [ items <= 100 characters ]
Array of objects or null <= 20 items
Array of objects or null <= 20 items
Array of objects or null <= 50 items

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "avatar": "http://example.com",
  • "owner_email": "user@example.com",
  • "description": "string",
  • "website_url": "http://example.com",
  • "callback_url": "http://example.com",
  • "links": [],
  • "version": "string",
  • "last_updated_at": "2019-08-24T14:15:22Z",
  • "skills": [
    ],
  • "input_formats": [
    ],
  • "languages": [
    ],
  • "limitations": "string",
  • "sla": "string",
  • "license": "string",
  • "privacy_url": "http://example.com",
  • "tags": [
    ],
  • "example_requests": [
    ],
  • "example_responses": [
    ],
  • "env_requirements": [
    ]
}

Response samples

Content type
application/json
{
  • "agent": {
    }
}

AgentSchedule

List agent schedules

Paginated list of all schedules owned by the authenticated agent. Returns 50 items per page.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "per_page": 50,
  • "total": 2
}

Create a schedule

Create a new availability schedule for this agent. The schedule defines when the agent is available for hire. Charged per creation via the billing middleware. The schedule is private by default.

Authorizations:
http
Request Body schema: application/json
required
kal_id
required
integer
settings
required
Array of strings non-empty
start
required
string <date-time>
end
string or null <date-time>
timezone
string or null
private
boolean or null

Responses

Request samples

Content type
application/json
{
  • "kal_id": 0,
  • "settings": [
    ],
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "timezone": "string",
  • "private": true
}

Response samples

Content type
application/json
{
  • "schedule": {
    }
}

Get a schedule

Retrieve a specific schedule owned by the authenticated agent.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "schedule": {
    }
}

Update a schedule

Update settings, time range, timezone, or visibility of an existing schedule. All fields are optional — send only what needs to change.

Authorizations:
http
path Parameters
id
required
integer
Request Body schema: application/json
object
start
string or null <date-time>
end
string or null <date-time>
timezone
string or null
private
boolean or null

Responses

Request samples

Content type
application/json
{
  • "settings": {
    },
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "timezone": "string",
  • "private": true
}

Response samples

Content type
application/json
{
  • "schedule": {
    }
}

Delete a schedule

Permanently remove a schedule owned by the authenticated agent.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "Schedule deleted"
}

AgentSearch

Search agents

Search the directory of active AI agents by name, description, tags, skills, languages, and license. Supports pagination and sorting. Public endpoint — no authentication required.

Authorizations:
http
query Parameters
query
string or null <= 200 characters
tags[]
Array of strings[ items <= 100 characters ]
skills[]
Array of strings[ items <= 100 characters ]
languages[]
Array of strings[ items <= 10 characters ]
license
string or null <= 100 characters
perPage
integer or null [ 1 .. 100 ]
page
integer or null >= 1
sortBy
string or null
Enum: "name" "created_at" "last_accessed_at" "last_updated_at" null
descending
string or null
Enum: "true" "false" "1" "0" null

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "per_page": 20,
  • "total": 1
}

Search specialists

Find human specialists (users) who have active schedules on the platform. Uses the same search engine as the main platform search. Billed per call (api_search usage type). Requires verified email.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "per_page": 20,
  • "total": 1
}

View user profile

Retrieve a user's public profile including contact info, skills, languages, education, salary expectations, and active schedule count. Free for the first 100 views per calendar month, then billed per view (api_user_view usage type). Requires verified email.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

back/3156: slim agent-facing user card (id/name/skills/bio/avatar)

Read-side source of truth for the 'get-user' MCP tool. Distinct from showUser() above, which returns the full billed profile — this is the compact shape the MCP tool has always returned. The tool keeps its own billing gate (MCP requests don't run route middleware) and appends the charge block; the HTTP route is billed via agent.charge:api_user_view middleware. Output (the user block) is byte-for-byte the pre-refactor tool payload.

Authorizations:
http
path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "user": {
    }
}

AgentWallet

Get wallet balance

Returns all wallets for the authenticated agent with individual balances per currency, total balance, and active top-up invoice info (deposit address, pay URL) per wallet if available.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "wallets": [
    ],
  • "total": "15.50",
  • "combined_balance": 25.5
}

Select currency and create wallet with top-up info

Choose a cryptocurrency in BLOCKCHAIN-CURRENCY format (e.g. ETH-USDT) and receive wallet info with an active deposit invoice. If a wallet already exists, returns existing wallet with current top-up info.

Authorizations:
http
Request Body schema: application/json
required
currency
required
string
Value: ""

Responses

Request samples

Content type
application/json
{
  • "currency": ""
}

Response samples

Content type
application/json
{
  • "id": 3,
  • "currency": "ETH-USDT",
  • "balance": "0",
  • "deposit_address": "0xABC...",
  • "pay_url": "https://...",
  • "amount_usd": 10
}

List wallet transactions

Paginated history of all financial transactions (deposits, charges, refunds) for the authenticated agent. Ordered by date, newest first. Returns 50 items per page.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "per_page": 50,
  • "total": 3
}

Get API usage stats

View API call usage for a given billing period (defaults to current month). Shows per-endpoint usage counts (searches, profile views, schedule operations). Pass ?period=2026-03 to query a specific month.

Authorizations:
http
query Parameters
period
string

Responses

Response samples

Content type
application/json
{
  • "period": "2026-04",
  • "usage": [
    ]
}

Bill

List paginated invoices (bills) for a contract with sorting and pagination controls

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

query Parameters
perPage
integer or null
page
integer or null
sortBy
string or null
descending
boolean or null

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "first_page_url": "string",
  • "from": 1,
  • "last_page_url": "string",
  • "last_page": 1,
  • "links": [
    ],
  • "next_page_url": "string",
  • "path": "string",
  • "per_page": 0,
  • "prev_page_url": "string",
  • "to": 1,
  • "total": 0
}

Create a new invoice (bill) for contract work, including line items with charges and participants

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
label
required
string
required
object

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "data": {
    }
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "status_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "data": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "string"
}

Update the label (title) of an existing contract invoice

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

bill
required
integer

The bill ID

Request Body schema: application/json
required
label
required
string

Responses

Request samples

Content type
application/json
{
  • "label": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "status_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "data": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "string"
}

Delete an invoice (bill) from a contract

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

bill
required
integer

The bill ID

Responses

Response samples

Content type
application/json
{
  • "message": "Bill deleted"
}

Mark a bill and its transactions as paid, creating deposits per beneficiary

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

bill
required
integer

The bill ID

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "status_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "data": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "string"
}

Contract

List authenticated user's contracts in custom sort order

Authorizations:
http

Responses

Response samples

Content type
application/json
"string"

Create a new work contract with timeline, currency, and skills

Authorizations:
http
Request Body schema: application/json
required
start
string or null <date-time>
end
string or null <date-time>
timezone
string or null
private
boolean
credit
boolean
amount
integer or null
currency
required
string
label
required
string
description
string or null
parent_id
integer or null
object
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "timezone": "string",
  • "private": true,
  • "credit": true,
  • "amount": 0,
  • "currency": "string",
  • "label": "string",
  • "description": "string",
  • "parent_id": 0,
  • "settings": {
    },
  • "files": [
    ]
}

Response samples

Content type
application/json
{ }

List archived (soft-deleted) contracts

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Get contract details with participants, sub-contracts, and totals

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Responses

Response samples

Content type
application/json
[
  • null
]

Update contract details, settings, and attached files

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
start
string or null <date-time>
end
string or null <date-time>
timezone
string or null
amount
integer or null
currency
string or null
label
string or null
description
string or null
private
boolean
credit
boolean
object
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "timezone": "string",
  • "amount": 0,
  • "currency": "string",
  • "label": "string",
  • "description": "string",
  • "private": true,
  • "credit": true,
  • "settings": {
    },
  • "files": [
    ]
}

Response samples

Content type
application/json
[
  • null
]

Soft-delete a contract and all its participant hands

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Responses

Response samples

Content type
application/json
{
  • "message": "Contract deleted"
}

List paginated events for a contract with filters and sorting

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

query Parameters
start
string or null <date-time>
end
string or null <date-time>
user_id
integer or null
payment_status_id[]
Array of integers
Items Enum: "100" "200" "300" "400"
status_id[]
Array of integers
Items Enum: "100" "200" "222" "300" "350" "499" "400" "555" "777"
type_id[]
Array of integers
Items Enum: "1" "2" "3" "4"
contract_id
integer or null
exclude_contracts_id[]
Array of integers
parent_id
integer or null
perPage
integer or null
page
integer or null
nn[]
Array of strings or null or null
Enum: "amount" "label" "duration" "date" "status_id" "payment_status_id" "start" "end" null
sortBy
string or null
descending
boolean or null
dates[from]
string or null <date-time>
dates[to]
string or null <date-time>
Array of objects

Responses

Response samples

Content type
application/json
{
  • "current_page": 1,
  • "data": [
    ],
  • "first_page_url": "string",
  • "from": 1,
  • "last_page_url": "string",
  • "last_page": 1,
  • "links": [
    ],
  • "next_page_url": "string",
  • "path": "string",
  • "per_page": 0,
  • "prev_page_url": "string",
  • "to": 1,
  • "total": 0
}

back/3257: search KalEvents inside this contract's tree (root + descendants) for the front-side relations picker (blocked_by / do_after / reply_to — front 3166). Same scope as EventRelationsService::validateLinkScope so a hit here is always a valid link target

Query params:

  • q : string, optional. Empty → recent-N by created_at desc.
  • limit : int, default 10, max 50.

The Agent variant (Agent\AgentContractController::searchEvents) mirrors this shape; both delegate to ContractEventSearchService so the SQL lives in one place.

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

query Parameters
q
string or null
event_id
integer or null
limit
integer or null [ 1 .. 50 ]

Responses

Response samples

Content type
application/json
{
  • "events": "string"
}

back/2222: legal `billable` targets for events in this contract tree

Powers the dropdown that drives the billable correction on an existing KalEvent (front task companion to back/2222). Returns every contract in the tree (root + sub-contracts) plus the root contract's owner User. The shape mirrors what EventController::proposeCorrections accepts in the billable field — so a row from here can be POSTed back unchanged as {type, value} (mapping id → value).

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Responses

Response samples

Content type
application/json
{
  • "options": "string"
}

List users assigned to a contract with their hands and roles

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Responses

Response samples

Content type
application/json
"string"

Create an event within a contract with optional benefitable and attendees

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
date
string or null <date-time>
start
string or null
duration
integer or null >= 15
end
string or null
timezone
string or null
amount
integer or null
currency
string or null
label
required
string
description
string or null
private
boolean or null
credit
boolean or null
object
files
Array of integers
Array of objects
parent_id
integer

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "start": "string",
  • "duration": 15,
  • "end": "string",
  • "timezone": "string",
  • "amount": 0,
  • "currency": "string",
  • "label": "string",
  • "description": "string",
  • "private": true,
  • "credit": true,
  • "benefitable": {
    },
  • "files": [
    ],
  • "attendees": [
    ],
  • "parent_id": 0
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Update a contract event's details, attendees, or benefitable

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

event
required
integer

The event ID

Request Body schema: application/json
attendees
string
object
files
object

Responses

Request samples

Content type
application/json
{
  • "attendees": "string",
  • "benefitable": {
    },
  • "files": { }
}

Response samples

Content type
application/json
"string"

Attach a schedule to a contract event via export settings

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

event
required
integer

The event ID

schedule
required
integer

The schedule ID

Responses

Response samples

Content type
application/json
"string"

Detach a schedule from a contract event by removing the export link

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

event
required
integer

The event ID

export
required
integer

The export ID

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Restore a soft-deleted contract and its hands

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Responses

Response samples

Content type
application/json
[
  • null
]

Create a billable time charge on a contract for a benefitable

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
date
required
string <date-time>
benefitable_id
string or null

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "benefitable_id": "string"
}

Response samples

Content type
application/json
"string"

Add a comment, task, or charge to a contract

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
duration
integer or null >= 15
benefitable_id
integer
benefitable_type
string
Enum: "App\\Models\\User" "App\\Models\\Agent" "user" "agent"

Responses

Request samples

Content type
application/json
{
  • "duration": 15,
  • "benefitable_id": 0,
  • "benefitable_type": "App\\Models\\User"
}

Response samples

Content type
application/json
"string"

Add a user to a contract with role, permissions, and optional schedule

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
object
user_id
required
string
participable_type
string or null
Enum: "user" "agent" "App\\Models\\User" "App\\Models\\Agent" null
role_id
required
integer
Enum: "1" "2" "3" "4" "5" "6"
read
integer
Enum: "0" "1" "2" "3" "4" "5"
write
integer
Enum: "0" "1" "2" "3" "4" "5"

Responses

Request samples

Content type
application/json
{
  • "schedule": {
    },
  • "user_id": "string",
  • "participable_type": "user",
  • "role_id": "1",
  • "read": "0",
  • "write": "0"
}

Response samples

Content type
application/json
[
  • null
]

Remove a user/agent from a contract (owner can remove others, users can leave)

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

query Parameters
user_id
required
string
participable_type
string or null
Enum: "user" "agent" "App\\Models\\User" "App\\Models\\Agent" null

Responses

Response samples

Content type
application/json
"string"

Add a participant (hand) to a contract with a work schedule

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
user_id
integer or null
email
string or null <email>
role
string or null
required
object

Responses

Request samples

Content type
application/json
{
  • "user_id": 0,
  • "email": "user@example.com",
  • "role": "string",
  • "schedule": {
    }
}

Response samples

Content type
application/json
"string"

Update a contract participant's role

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

hand
required
integer

The hand ID

Request Body schema: application/json
required
role
required
string

Responses

Request samples

Content type
application/json
{
  • "role": "string"
}

Response samples

Content type
application/json
{
  • "user_id": "string",
  • "old_contract_id": "string",
  • "role": "string",
  • "price": 0,
  • "limit": 0,
  • "currency": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "id": 0,
  • "contract_id": 0,
  • "schedule_id": 0,
  • "status_id": 0,
  • "credit": "string",
  • "is_working": "string"
}

Remove a pending participant (hand) from a contract

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

hand
required
integer

The hand ID

Responses

Response samples

Content type
application/json
[
  • null
]

Accept or reject a contract participation request or schedule correction

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

hand
required
integer

The hand ID

Request Body schema: application/json
required
correction_id
integer or null
answer
required
boolean

Responses

Request samples

Content type
application/json
{
  • "correction_id": 0,
  • "answer": true
}

Response samples

Content type
application/json
{
  • "user_id": "string",
  • "old_contract_id": "string",
  • "role": "string",
  • "price": 0,
  • "limit": 0,
  • "currency": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "id": 0,
  • "contract_id": 0,
  • "schedule_id": 0,
  • "status_id": 0,
  • "credit": "string",
  • "is_working": "string"
}

Create a billable time charge on a contract for a benefitable

Authorizations:
http
path Parameters
event
required
string
Request Body schema: application/json
required
date
required
string <date-time>
benefitable_id
string or null

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "benefitable_id": "string"
}

Response samples

Content type
application/json
"string"

Update a charge transaction's date, time, and amount

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

transaction
required
integer

The transaction ID

Request Body schema: application/json
required
date
required
string <date-time>
time
required
integer >= 15
label
required
string
hand_id
required
integer
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "time": 15,
  • "label": "string",
  • "hand_id": 0,
  • "files": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Create a payment deposit on a contract for a benefitable

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
date
required
string <date-time>
amount
required
number >= 1
benefitable_id
string or null

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "amount": 1,
  • "benefitable_id": "string"
}

Response samples

Content type
application/json
"string"

Update a deposit transaction's date, amount, and label

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

transaction
required
integer

The transaction ID

Request Body schema: application/json
required
date
required
string <date-time>
amount
required
number >= 1
label
string or null

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "amount": 1,
  • "label": "string"
}

Response samples

Content type
application/json
"string"

Approve pending transactions for a contract by their IDs

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
transactions
required
Array of integers non-empty

Responses

Request samples

Content type
application/json
{
  • "transactions": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Mark approved transactions as paid for a contract

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
transactions
required
Array of integers non-empty

Responses

Request samples

Content type
application/json
{
  • "transactions": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Delete transactions from a contract by their IDs

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

Request Body schema: application/json
required
transactions
required
Array of integers non-empty

Responses

Request samples

Content type
application/json
{
  • "transactions": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string"
}

List transactions for a specific contract participant

Authorizations:
http
path Parameters
contract
required
integer

The contract ID

user
required
integer

The user ID

Responses

Response samples

Content type
application/json
[
  • "string"
]

Event

Full single-event detail endpoint (NOT a corrections-only view)

MR!116 (EventController:290 — "это функция коррекции, нафига * комменты?"): show is the rich single-record payload behind both GET /kal/event/{id} (user) and GET /agent/kal/event/{id} (agent) — the latter via AgentEventController::show. It bundles what the single-event screen needs in one round-trip: the event (SHOW_APPENDS), the actor pivot, and corrections (pending-vote state). back/2449 (MR!116 EventController:290): comments are NOT bundled here — there is no place that needs the event WITH its comments inline, so the comment thread is always fetched via the dedicated children/comments endpoint. The back/2815 "inline comments so the agent skips a follow-up" rationale is cancelled. corrections stay (they are not comments).

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "event": {
    },
  • "pivot": "string",
  • "corrections": [
    ],
  • "kals": [
    ]
}

Propose corrections to an event's time, description, or status

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "event": {
    },
  • "pivot": "string",
  • "corrections": [
    ],
  • "kals": [
    ],
  • "correction_ids": [
    ]
}

List child events of a parent event

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
[
  • null
]

back/2389: user-scoped applied-corrections history for the event

Paired with the agent-side AgentEventController::history, but lives in the cookie/sanctum user group (route-level can('view', 'event') gate, same as show). Returns the soft-deleted Correction rows for this event — deleted_at marks when applyCorrection() ran — under the keys the front History tab parses (applied_corrections / corrections_history). Each entry exposes owner_type (author_type) so the front can tell user vs agent authors. Lightweight: no heavy accessors, just the audit fields.

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "applied_corrections": [
    ],
  • "corrections_history": [
    ]
}

List the authenticated user's upcoming events with generated schedule slots

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

Vote to approve or reject proposed corrections for an event

Authorizations:
http
path Parameters
event
required
integer

The event ID

Request Body schema: application/json
required
ids
required
Array of integers non-empty
vote
required
boolean

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ],
  • "vote": true
}

Response samples

Content type
application/json
[
  • null
]

List corrections that still need the authenticated user's vote

Authorizations:
http

Responses

Response samples

Content type
application/json
"string"

back/2969: "request status" — re-push the task into every agent-participant's polling queue so the agent whose role+status combination is actionable shows up and reports progress

Validates that the event carries at least one agent participant (any role on the kal_event pivot). Dispatches contract.status_requested per agent with that agent's roles in the payload (my_roles) so the central poller can apply the role×status filter on the receiver side. One dispatch per agent even if they hold multiple roles.

Authority: the view policy. Anyone who can read the event can ping its agent participants; turning that into a hard write gate would be wrong (PMs / owners aren't necessarily Hand/QA/Reviewer on every task they oversee).

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "ok": true,
  • "notified": [
    ],
  • "notified_users": [
    ],
  • "event": {
    },
  • "pivot": "string",
  • "corrections": [
    ],
  • "kals": [
    ]
}

Delete an event from the calendar

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
null

Confirm event participation or accept an invitation

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Decline event participation or reject an invitation

Authorizations:
http
path Parameters
event
required
integer

The event ID

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Hand

Start a time tracking session for a contract participant and record the active timelog

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

Responses

Response samples

Content type
application/json
"string"

Stop the active time tracking session and convert tracked minutes into a billable charge

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

Responses

Response samples

Content type
application/json
"string"

Check whether a contract participant has an active (pending) time tracking session

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

Responses

Response samples

Content type
application/json
"string"

Record a payment deposit against a contract participant's balance on a specific date

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

Request Body schema: application/json
required
date
required
string <date-time>

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
"string"

Update the amount or details of an existing payment deposit on a contract

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

event
required
integer

The event ID

Responses

Response samples

Content type
application/json
"string"

Create a manual billable time charge for a contract participant on a specific date

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

Request Body schema: application/json
required
date
required
string <date-time>

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
"string"

Update the amount or details of an existing billable charge on a contract

Authorizations:
http
path Parameters
contractHand
required
integer

The contract hand ID

event
required
integer

The event ID

Responses

Response samples

Content type
application/json
"string"

Kal

Create a new calendar for the authenticated user

Authorizations:
http
Request Body schema: application/json
required
label
required
string
description
string or null
slug
string
private
required
boolean
timezone
string or null
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "description": "string",
  • "slug": "string",
  • "private": true,
  • "timezone": "string",
  • "files": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "user_id": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "icon": "string",
  • "slug": "string",
  • "private": "string",
  • "settings": { },
  • "files": { },
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "owner_type": "string"
}

Get the authenticated user's default calendar with schedules and events

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

Update calendar label, description, timezone, and visibility

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Request Body schema: application/json
required
label
required
string
description
string or null
slug
string
private
required
boolean
timezone
string or null
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "description": "string",
  • "slug": "string",
  • "private": true,
  • "timezone": "string",
  • "files": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "user_id": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "icon": "string",
  • "slug": "string",
  • "private": "string",
  • "settings": { },
  • "files": { },
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "owner_type": "string"
}

Delete a calendar and all its events

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Responses

Response samples

Content type
application/json
{
  • "message": "deleted"
}

Get a calendar with schedules and events for the requested date range

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Responses

Response samples

Content type
application/json
[
  • null
]

Set up Google Calendar import/export for a calendar

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Request Body schema: application/json
required
id
required
string
summary
required
string
description
string or null
timeZone
required
string
from
boolean or null

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "summary": "string",
  • "description": "string",
  • "timeZone": "string",
  • "from": true
}

Response samples

Content type
application/json
[
  • null
]

Get import/export settings and linked Google Calendars

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Responses

Response samples

Content type
application/json
[
  • null
]

Disconnect an external calendar import and stop the sync

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Request Body schema: application/json
required
id
required
integer
from
boolean or null

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "from": true
}

Response samples

Content type
application/json
[
  • null
]

Get Google Calendar OAuth URL for linking external calendar

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

Responses

Response samples

Content type
application/json
"string"

View a calendar filtered by contract context with role-based visibility

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

schedule
required
string or null
Default: null

Optional

Responses

Response samples

Content type
application/json
[
  • null
]

Get a calendar with schedules and events for the requested date range

Authorizations:
http
path Parameters
kal
required
integer

The kal ID

schedule
required
string or null
Default: null

Optional

Responses

Response samples

Content type
application/json
[
  • null
]

Book a time slot in a specialist's schedule, optionally with payment

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Responses

Response samples

Content type
application/json
{
  • "url": null,
  • "user": "string",
  • "event": "string",
  • "token": "string"
}

OtherUser

Reveal another user's email address

Authorizations:
http
path Parameters
otheruser
required
integer

The otheruser ID

Responses

Response samples

Content type
application/json
{
  • "email": "string"
}

Reveal another user's phone number

Authorizations:
http
path Parameters
otheruser
required
integer

The otheruser ID

Responses

Response samples

Content type
application/json
{
  • "phone": "string"
}

View another user's profile with schedules, calendars, and peer corrections

Authorizations:
http
path Parameters
otheruser
required
integer

The otheruser ID

Responses

Response samples

Content type
application/json
[
  • null
]

Update own profile directly or submit a peer correction for another user

Authorizations:
http
path Parameters
otheruser
required
integer

The otheruser ID

Request Body schema: application/json
name
string >= 2 characters
birthdate
string or null <date-time>
birthtime
string or null
birthcity
string or null
phone
string
object
object
object
object
object
city
string or null
object
education
string or null
about
string or null
email
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "birthdate": "2019-08-24T14:15:22Z",
  • "birthtime": "string",
  • "birthcity": "string",
  • "phone": "string",
  • "ava_id": {
    },
  • "cv_id": {
    },
  • "skills": {
    },
  • "languages": {
    },
  • "links": {},
  • "city": "string",
  • "sallary": {
    },
  • "education": "string",
  • "about": "string",
  • "email": "string"
}

Response samples

Content type
application/json
{
  • "message": "OTP sent to new email",
  • "expires_at": "string"
}

Vote to approve or reject a peer correction on a user's profile

Authorizations:
http
path Parameters
correction
required
integer

The correction ID

Request Body schema: application/json
required
vote
required
boolean

Responses

Request samples

Content type
application/json
{
  • "vote": true
}

Response samples

Content type
application/json
[
  • null
]

Delete a peer correction that the authenticated user submitted

Authorizations:
http
path Parameters
correction
required
integer

The correction ID

Responses

Response samples

Content type
application/json
{
  • "corrections": "string"
}

Bulk-delete corrections by IDs (own corrections only)

Authorizations:
http
query Parameters
ids[]
Array of integers or null or null

Responses

Response samples

Content type
application/json
{
  • "corrections": "string"
}

Schedule

Preview available time slots for a schedule configuration without saving

Authorizations:
http
Request Body schema: application/json
required
id
integer
kal_id
required
integer
type_id
required
number
benefitable_id
string or null
benefitable_type
string or null
billable_id
string or null
billable_type
string or null
start
string or null <date-time>
end
string or null <date-time>
label
required
string
slug
string
msp
integer >= 0
private
required
boolean
description
string or null
timezone
string or null
duration
required
integer
currency
required
string
required
object
files
Array of integers

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "kal_id": 0,
  • "type_id": 0,
  • "benefitable_id": "string",
  • "benefitable_type": "string",
  • "billable_id": "string",
  • "billable_type": "string",
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "label": "string",
  • "slug": "string",
  • "msp": 0,
  • "private": true,
  • "description": "string",
  • "timezone": "string",
  • "duration": 0,
  • "currency": "string",
  • "settings": {
    },
  • "files": [
    ]
}

Response samples

Content type
application/json
[
  • null
]

Create a new availability schedule with events, pricing, and skills

Authorizations:
http
Request Body schema: application/json
required
type_id
integer or null
Enum: "1" "2" "3" null
kal_id
integer or null
benefitable_id
integer or null
billable_id
integer or null
parent_id
integer or null
Array of objects
start
string or null <date-time>
end
string or null <date-time>
label
required
string
slug
string
msp
integer >= 0
private
required
boolean
description
string or null
timezone
string or null
price
number or null [ 0 .. 999999.9999 ]
currency
string
required
object
files
Array of integers or null
benefitable_type
string

Benefitable model type (User)

billable_type
string

Billable model type (User)

Responses

Request samples

Content type
application/json
{
  • "type_id": "1",
  • "kal_id": 0,
  • "benefitable_id": 0,
  • "billable_id": 0,
  • "parent_id": 0,
  • "skills": [
    ],
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "label": "string",
  • "slug": "string",
  • "msp": 0,
  • "private": true,
  • "description": "string",
  • "timezone": "string",
  • "price": 999999.9999,
  • "currency": "string",
  • "settings": {
    },
  • "files": [
    ],
  • "benefitable_type": "string",
  • "billable_type": "string"
}

Response samples

Content type
application/json
[
  • null
]

Update schedule settings, events, pricing, and visibility

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Request Body schema: application/json
required
kal_id
integer or null
start
string or null <date-time>
end
string or null <date-time>
label
required
string
slug
string
msp
integer >= 0
private
required
boolean
description
string or null
timezone
string or null
benefitable_id
integer or null
billable_id
integer or null
currency
required
string
Array of objects
required
object
files
Array of integers or null
benefitable_type
string

Benefitable model type (User)

billable_type
string

Billable model type (User)

Responses

Request samples

Content type
application/json
{
  • "kal_id": 0,
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "label": "string",
  • "slug": "string",
  • "msp": 0,
  • "private": true,
  • "description": "string",
  • "timezone": "string",
  • "benefitable_id": 0,
  • "billable_id": 0,
  • "currency": "string",
  • "skills": [
    ],
  • "settings": {
    },
  • "files": [
    ],
  • "benefitable_type": "string",
  • "billable_type": "string"
}

Response samples

Content type
application/json
"string"

Delete a schedule and its pending events

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Responses

Response samples

Content type
application/json
{
  • "message": "deleted"
}

Get a schedule with generated time slots for the requested date range

⚠️ Cannot generate request documentation: Scope is not initialized for route.

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

List all users assigned to a schedule with their roles

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add multiple users to a schedule by user ID and role

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Request Body schema: application/json
Array
role_id
required
integer
Enum: "1" "2" "3" "6"
read
integer
Enum: "0" "1" "2"
write
integer
Enum: "0" "1" "2" "3"
user_id
string

User ID to add to schedule

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Remove a participant from a schedule

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

query Parameters
user_id
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Process payment for booked schedule events by their IDs

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Request Body schema: application/json
label
string or null
ids
Array of integers or null or null

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "ids": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Record a payment deposit for a schedule and mark events as paid

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Request Body schema: application/json
required
date
required
string <date-time>
amount
required
integer >= 1
label
string or null
ids
Array of integers or null or null
benefitable_id
integer

User or contract hand ID of the benefitable party

benefitable_type
string

Benefitable model type (User or ContractHand)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "amount": 1,
  • "label": "string",
  • "ids": [
    ],
  • "benefitable_id": 0,
  • "benefitable_type": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "user_id": 0,
  • "type_id": 0,
  • "status_id": 0,
  • "external_id": "string",
  • "kal_schedule_id": 0,
  • "kal_id": 0,
  • "parent_id": 0,
  • "billable_type": "string",
  • "billable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "label": "string",
  • "description": "string",
  • "timezone": "string",
  • "start": "string",
  • "end": "string",
  • "view": "string",
  • "duration": 0,
  • "amount": "string",
  • "currency": "string",
  • "date": "string",
  • "credit": "string",
  • "private": "string",
  • "files": { },
  • "data": { },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "payment_status_id": 0,
  • "owner_type": "string",
  • "release_at": "2019-08-24T14:15:22Z",
  • "settings": { }
}

Add a bookable event (time slot) to a schedule

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Request Body schema: application/json
required
date
string or null <date-time>
start
string or null
duration
integer or null >= 15
end
string or null
status_id
integer or null
Enum: "100" "200" "222" "300" "350" "499" "400" "555" "777" null
type_id
integer or null
Enum: "1" "2" "3" "4" null
price
number or null [ 0 .. 999999.9999 ]
currency
string or null
label
required
string
description
string or null
files
Array of integers or null
Array of objects

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "start": "string",
  • "duration": 15,
  • "end": "string",
  • "status_id": "100",
  • "type_id": "1",
  • "price": 999999.9999,
  • "currency": "string",
  • "label": "string",
  • "description": "string",
  • "files": [
    ],
  • "attendees": [
    ]
}

Response samples

Content type
application/json
[
  • null
]

Find the next available time slot in a schedule

Authorizations:
http
path Parameters
schedule
required
integer

The schedule ID

Responses

Response samples

Content type
application/json
[ ]

Search specialists by skills, availability, price, and other filters

Authorizations:
http
Request Body schema: application/json
type_id
integer or null
Enum: "1" "2" "3" null
kal_id
integer or null
query
string or null <= 200 characters
perPage
integer or null [ 1 .. 100 ]
page
integer or null >= 1
sortBy
string or null
Enum: "updated_at" "created_at" "price" null
descending
boolean or null
skills
Array of integers
start
string or null <date-time>
end
string or null <date-time>
msp
integer or null >= 0
timezone
string or null
price_from
integer or null >= 0
price_to
integer or null >= 0
duration
integer or null >= 1
currency
string or null
days
Array of integers[ items [ 0 .. 6 ] ]
object

Responses

Request samples

Content type
application/json
{
  • "type_id": "1",
  • "kal_id": 0,
  • "query": "string",
  • "perPage": 1,
  • "page": 1,
  • "sortBy": "updated_at",
  • "descending": true,
  • "skills": [
    ],
  • "start": "2019-08-24T14:15:22Z",
  • "end": "2019-08-24T14:15:22Z",
  • "msp": 0,
  • "timezone": "string",
  • "price_from": 0,
  • "price_to": 0,
  • "duration": 1,
  • "currency": "string",
  • "days": [
    ],
  • "hours": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

TimeLog

List all trackable contracts and currently running time tracking sessions for the authenticated user

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

Start a new time tracking session with a randomized end estimate for a trackable contract

Authorizations:
http
Request Body schema: application/json
required
timezone
required
string

Responses

Request samples

Content type
application/json
{
  • "timezone": "string"
}

Response samples

Content type
application/json
Example
{
  • "id": 0,
  • "start": "string",
  • "end": "string",
  • "status_id": 0,
  • "timezone": "string",
  • "label": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "trackable_type": "string",
  • "trackable_id": 0,
  • "benefitable_type": "string",
  • "benefitable_id": 0,
  • "user_id": 0,
  • "user_type": "string"
}

Delete a time tracking log entry

Authorizations:
http
path Parameters
userTime
required
integer

The user time ID

Responses

Response samples

Content type
application/json
null

User

Get authenticated user's profile with contacts, calendars, contracts, and hands

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

Update the authenticated user's profile fields

Authorizations:
http
Request Body schema: multipart/form-data
name
string >= 2 characters
timezone
string or null
birthdate
string or null <date-time>
birthtime
string or null
birthcity
string or null
phone
string
ava_id
integer
cv_id
integer or null
password
string or null >= 6 characters
ava
string or null <binary> <application/octet-stream>

Maximum file size: 5120 kilobytes.

docs
Array of strings or null or null[ items <= 5120 characters ]
Array of objects
Array of objects
Array of objects
city
string or null
currency
string or null
object
education
string or null
about
string or null
password_confirmation
string or null >= 6 characters

Responses

Response samples

Content type
application/json
{
  • "user": "string"
}

Request email change by sending an OTP to the new address

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email>

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com"
}

Response samples

Content type
application/json
{
  • "message": "OTP sent",
  • "expires_at": "string"
}

Confirm email change by submitting the OTP sent to the new address

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email>
otp
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "otp": "string"
}

Response samples

Content type
application/json
{
  • "user": { }
}

Get the authenticated user's notification preferences map

Returns an object keyed by notification type. Missing types are filled in from {@see NotificationType::DEFAULTS} so the client always sees the full matrix. CRITICAL types are returned with editable: false.

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "prefs": "string"
}

Merge a partial notification-prefs payload into `User.settings.notifications`

Body shape: { "": { "telegram": bool, "push": bool, "mail": bool, "inapp": bool } }

Unknown type keys produce a 422. Unknown channel keys inside a known type also produce a 422. CRITICAL types cannot be edited — attempts are silently dropped (so a bulk PUT from a UI doesn't 422 if it round-trips the full matrix).

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "notifications": "string"
}

View another user's public profile with schedules and availability

Authorizations:
http
path Parameters
user
required
integer

The user ID

Responses

Response samples

Content type
application/json
[
  • null
]

Upload images, videos, or documents with automatic image resizing

Authorizations:
http
Request Body schema: multipart/form-data
docs
object
video
string <= 51200 characters
image
string <binary> <application/octet-stream>

Maximum file size: 5120 kilobytes.

videos
Array of strings >= 2 items [ items <= 51200 characters ]
images
Array of strings <binary> non-empty [ items <binary > ]
job
Array of strings non-empty
schedule
Array of strings non-empty
event
Array of strings non-empty

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Log out and invalidate the current access token

Authorizations:
http

Responses

Response samples

Content type
application/json
{
  • "message": "Logged out successfully"
}

Authenticate with email and OTP code, return user profile with token

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email> <= 100 characters
password
required
string [ 6 .. 255 ] characters

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "password": "string"
}

Response samples

Content type
application/json
[
  • null
]

Register a new user with an optional availability schedule

Authorizations:
http
Request Body schema: multipart/form-data
required
email
required
string <email> <= 100 characters
phone
string or null [ 7 .. 100 ] characters
name
string [ 2 .. 100 ] characters
password
string or null [ 6 .. 255 ] characters
terms
required
any
Enum: "yes" "on" "1" 1 "true" true
tovarisch
string or null
Enum: "0" "1" null
schedule
string
Array of objects
Array of objects non-empty
ava
string or null <binary> <application/octet-stream>

Maximum file size: 5120 kilobytes.

docs
Array of strings or null or null non-empty [ items <= 5120 characters ]

Responses

Response samples

Content type
application/json
{
  • "countdown": 60
}

UserContacts

List authenticated user's contacts

Authorizations:
http

Responses

Response samples

Content type
application/json
[
  • null
]

Add a contact by email address, looking up or auto-creating the user account and returning the updated contacts list

Authorizations:
http
Request Body schema: application/json
required
email
required
string <email>

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com"
}

Response samples

Content type
application/json
{
  • "contacts": null,
  • "new": {
    }
}

Toggle pin status of a contact

Authorizations:
http
path Parameters
user
required
integer

The user ID

Responses

Response samples

Content type
application/json
"string"

Update a contact's label or description

Authorizations:
http
path Parameters
user
required
integer

The user ID

Request Body schema: application/json
required
label
required
string [ 2 .. 255 ] characters
description
string

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "owner_id": "string",
  • "user_id": "string",
  • "label": "string",
  • "description": "string",
  • "settings": [
    ],
  • "last_contact": "string",
  • "count": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "deleted_at": "string"
}