---
title: "Mời người dùng vào workspace"
method: POST
path: "/ir/{symbol}/invitations"
tags: ["IRPortal"]
---

# Mời người dùng vào workspace

`POST /ir/{symbol}/invitations`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/ir/{symbol}/invitations`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-write`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/ir/:symbol/invitations/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `symbol` string, required

## Request body

- FireAntApiModelsIRIRInvitationRequest: Mời người dùng vào workspace
  - `email` string, required: Email người được mời
  - `role` 1 | 2 | 3 | 4 | 5: Vai trò sẽ cấp (1 = Owner, 2 = Admin, 3 = Editor, 4 = Analyst, 5 = Viewer)
  - `expiresInDays` integer: Số ngày hiệu lực (mặc định 14)

## Response `200`

OK

- FireAntApiModelsIRIRInvitationItem: Lời mời tham gia workspace
  - `invitationId` integer: ID lời mời
  - `companyId` integer: ID công ty
  - `symbol` string: Mã chứng khoán
  - `companyName` string: Tên công ty
  - `email` string: Email được mời
  - `role` 1 | 2 | 3 | 4 | 5: Vai trò sẽ được cấp (1 = Owner, 2 = Admin, 3 = Editor, 4 = Analyst, 5 = Viewer)
  - `token` string: Mã lời mời (chỉ trả về cho người quản lý workspace)
  - `expiresDate` string, date-time: Hạn dùng
  - `status` 0 | 1 | 2 | 3: Trạng thái (0 = Pending, 1 = Accepted, 2 = Revoked, 3 = Expired)
  - `acceptedUserName` string: Tài khoản đã chấp nhận
  - `acceptedDate` string, date-time: Thời điểm chấp nhận
  - `createdBy` string: Người tạo
  - `createdDate` string, date-time: Ngày tạo

## Changes

- **2026-09-25** `a481789cd81c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/ir/:symbol/invitations/post.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)