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

Wethod-Company stringrequired

The company you want to interact with

Wethod-Version stringrequired

The API version you want to use

application/json

Body

person_id integerrequired

ID of the person to associate with this allocation

project_id integerrequired

ID of the project to associate with this allocation

date daterequired

Allocation date. This follows the YYYY-MM-DD format

hours integerrequired

Possible values: >= 1 and <= 8

Allocation total hours

Responses

201

Returns the allocation created.

application/json

Schema

Schema

id integerrequired

Possible values: >= 1

created_at date-timerequired
updated_at date-timerequired
date daterequired
hours integerrequired

Possible values: <= 8

project_id integerrequired

Possible values: >= 1

ID of the project related to this allocation

person_id integerrequired

Possible values: >= 1

ID of the person related to this allocation

deleted_at date-time

Example (from schema)

{
  "id": 1,
  "created_at": "2024-12-20T14:44:08.238Z",
  "updated_at": "2024-12-20T14:44:08.238Z",
  "date": "2024-12-20",
  "hours": 4,
  "project_id": 1,
  "person_id": 1,
  "deleted_at": "2024-12-20T14:44:08.238Z"
}

400

Validation failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

failures

object[]

List of validation errors

Array [

field string

Name of the field causing the error

message string

Human-readable description of the error

]

Example (from schema)

{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

Loading...