Create a person allocation
POST/api/people-allocations
Required permissions:
- planning.modify: to create allocation for a project where the user is PM or Account
- planning.modify_other: to create allocation for a project where the user is not PM nor Account
- planning.modify_past: to create allocation on today or in a date in the past
Here the dedicated support page.
Request
Header Parameters
The company you want to interact with
The API version you want to use
- application/json
Body
ID of the person to associate with this allocation
ID of the project to associate with this allocation
Allocation date. This follows the YYYY-MM-DD format
Possible values: >= 1 and <= 8
Allocation total hours
Responses
- 201
- 400
- 401
- 403
- 412
Returns the allocation created.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: <= 8
Possible values: >= 1
ID of the project related to this allocation
Possible values: >= 1
ID of the person related to this allocation
The date and time when the resource was deleted
{
"id": 1,
"created_at": "2026-04-24T10:03:54.026Z",
"updated_at": "2026-04-24T10:03:54.026Z",
"date": "2026-04-24",
"hours": 4,
"project_id": 1,
"person_id": 1,
"deleted_at": "2026-04-24T10:03:54.026Z"
}
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
- ResponseHeaderBag
Array [
]
headers
object
oneOf
Default value: 64
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
"headers": {},
"content": "string",
"version": "string",
"status_code": 0,
"status_text": "string",
"charset": "string",
"callback": "string",
"encoding_options": 64,
"key": "invalid_data",
"message": "You provided invalid data. Check 'failures' for details.",
"failures": [
{
"field": "string",
"message": "string"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
- ResponseHeaderBag
headers
object
oneOf
Default value: 64
Error unique key
Human-readable message describing the error
{
"headers": {},
"content": "string",
"version": "string",
"status_code": 0,
"status_text": "string",
"charset": "string",
"callback": "string",
"encoding_options": 64,
"key": "string",
"message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
- ResponseHeaderBag
headers
object
oneOf
Default value: 64
Error unique key
Human-readable message describing the error
{
"headers": {},
"content": "string",
"version": "string",
"status_code": 0,
"status_text": "string",
"charset": "string",
"callback": "string",
"encoding_options": 64,
"key": "string",
"message": "string"
}
Precondition failed
- application/json
- Schema
- Example (from schema)
Schema
- ResponseHeaderBag
headers
object
oneOf
Default value: 64
Error unique key
Human-readable message describing the error
{
"headers": {},
"content": "string",
"version": "string",
"status_code": 0,
"status_text": "string",
"charset": "string",
"callback": "string",
"encoding_options": 64,
"key": "precondition_failure",
"message": "string"
}