Skip to content

Create a new project

POST
/projects

Create a new project (student role required)

X-User-Role
required
string
Allowed values: student

Student role required for this endpoint

object
project_name
required

Name of the project

string
<= 255 characters
project_desc
required

Detailed description of the project

string
company_id
required

ID of the company associated with the project

integer
>= 1
project_status
required

Current status of the project

string
Allowed values: active completed cancelled on_hold
project_url

URL to project repository or documentation

string format: uri
start_date
required

Project start date

string format: date
end_date
required

Project end date

string format: date

Project created successfully

object
success
boolean
data

Created resource data

message

Optional success message

string

Bad request - invalid input

object
success
required

Indicates if the request was successful

boolean
message
required

Response message

string
success
boolean
message
string
Allowed values: BAD_REQUEST

Unauthorized - authentication required

object
success
required

Indicates if the request was successful

boolean
message
required

Response message

string
success
boolean
message
string
Allowed values: UNAUTHORIZED

Conflict - resource already exists

object
success
required

Indicates if the request was successful

boolean
message
required

Response message

string
success
boolean
message
string
Allowed values: CONFLICT

Internal server error

object
success
required

Indicates if the request was successful

boolean
message
required

Response message

string
success
boolean
message
string
Allowed values: INTERNAL_SERVER_ERROR