Creates a new access request for a specific project. Users can submit a request and optionally include a message.
The number in the URL path (/1/) is the organization identifier — referred to as account_id.
This value must match the account associated with the provided session_id.
This endpoint supports both:
GET https://api.doboard.com/42/project_access_add?task_id=35?=&session_id=abc123xyz
In this example:
42 is the organization/account IDtask_id=35 ID of the task to request access tosession_id=abc123xyz is used for authenticationRequired
This method is available only to authenticated users with the following roles:
Additionally, the user should not have access to the specified project.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string |
Yes | – | Session ID (13–32 alphanumeric characters) |
task_id |
int |
Yes | – | ID of the task to request access to |
request_message |
string |
No | – | Optional message attached to the access request |
{
"data": {
"operation_status": "SUCCESS",
"request_id": 23
}
}
| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
Unauthorized |
No session or token provided |
200 |
8001 |
Access already exists |
A pending request from this user already exists |
200 |
8002 |
task_id is required |
Missing task_id |
200 |
8003 |
Task Not Found |
Invalid task_id |
500 |
0 |
Internal API Error |
Internal error |
200 |
7 |
limit reached |
Too many session attempts from same IP |
| Role | Requires Existing Access | Allowed |
|---|---|---|
ADMIN |
– | – |
PROJECT_MANAGER |
❌ No | ✅ Yes |
USER |
❌ No | ✅ Yes |
GUEST |
– | ❌ No |