Team: Roles
🔒 Назначение новой должности/роли сотруднику в компании.
Назначение новой должности/роли сотруднику в компании.
Access: authorized (10 ) · Scope: write
Allows: user:employment (все обязательны; проверка в команде по ресурсу из запроса)
TypeScript (copy-paste)
POST /team/role/create
<details open><summary><b>Params</b></summary>export interface TeamRoleCreateParams {
userID: string
}
</details>
<details open><summary><b>Body (Partial)</b></summary>
// Patch-body: все поля опциональны (Valid.Patch)
export type TeamRoleCreateBody = Partial<UserDto>
export interface TeamRoleCreateBodyFields {
ID?: string
userID?: string
cID?: string
type?: UserRole_Type
level?: UserRole_Level
title?: string | null
award?: number
salary?: number
total?: number
/** Day key (YYYYMMDD or internal day index) */
startDK?: number
/** Day key (YYYYMMDD or internal day index) */
trialEndDK?: number | null
/** Day key (YYYYMMDD or internal day index) */
endDK?: number | null
note?: Record<string, any> | null
isDeleted?: boolean
isMain?: boolean | null
/** Unix timestamp in milliseconds */
updTS?: number
updUID?: string
}
</details>
<details open><summary><b>Response</b></summary>
export type TeamRoleCreateResponse = IServerResponse<UserDto>
export interface IServerResponse<T = any> {
code: number
data: T
srvTS: number
rkey: string
}
</details>
Полный файл типов: /docs/types · raw: /docs/api-types.ts
post/team/role/create
Request
- Base URL: http://localhost
- URL: http://localhost/team/role/create
- Auth: one of:
- API key in header sid and API key in header rts and API key in header sig
- HTTP bearer
Query parameters
userIDstring uuid required
Можно передать header userID (сервер мержит headers+query)
Headers
devIDstring uuid required
UUID устройства клиента
tzstring required
Example:Europe/Moscow
Таймзона клиента (IANA или offset)
appstring required
Example:kosmodrom-web
Имя клиентского приложения
appVerstring required
Example:1.0.0
Версия клиента
rKeystring
Уникальный ключ запроса для логов/саппорта
Request body
Response
OK — IServerResponse<UserDto>
Example response
{
"code": 200
}Changes
No recorded changes to this operation across all 1 revision of this API.