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

IDstring uuid
userIDstring uuid
cIDstring uuid
type10 | 20 | 30 | 40 | 50 | 60 | 70

management = 10, analytics = 20, marketing = 30, design = 40, development = 50, qa = 60, support = 70

level-1 | 1 | 10 | 50 | 100 | 1000

intern = -1, junior = 1, middle = 10, upperMiddle = 50, senior = 100, lead = 1000

titlestring nullable
awardinteger
salaryinteger
totalinteger
startDKinteger

Day key (YYYYMMDD or internal day index)

trialEndDKinteger nullable

Day key (YYYYMMDD or internal day index)

endDKinteger nullable

Day key (YYYYMMDD or internal day index)

noteobject nullable
isDeletedboolean
isMainboolean nullable
updTSinteger

Unix timestamp in milliseconds

updUIDstring

Response

OK — IServerResponse<UserDto>

codeinteger required
srvTSinteger required

Server timestamp (ms)

rkeystring required

Request key

Example response

{
  "code": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.