Planning Entries

German: “Planung”

• Attributes
• GET /planning_entries
• GET /planning_entries/{id}
• POST /planning_entries
• PUT /planning_entries/{id}
• DELETE /planning_entries/{id}

Attributes

The planning entry representation contains among the standard fields also:

• assigned user (staff)
• either project or deal, the other is set to null
• deal attributes (project attributes are given in the example below):

  {
    "id": 6542,
    "name": "Redesign website",
    "customer_name": "Acme GmbH",
    "color": "#aacb84"
  }
  

{
  "id": 4839,
  "starts_on": "2020-05-04",
  "ends_on": "2020-05-04",
  "hours_per_day": 6.0,
  "comment": "",
  "symbol": null,
  "color": "#2965cc",
  "read_only": false,
  "user": {
    "id": 5484,
    "firstname": "Thomas",
    "lastname": "Munster"
  },
  "project": {
    "id": 4553,
    "identifier": "130",
    "name": "Support",
    "customer_name": "Acme GmbH",
    "color": "#faeb44"
  },
  "deal": null,
  "series_id": null,
  "series_repeat": null,
  "created_at": "2018-10-17T09:33:46Z",
  "updated_at": "2018-10-17T09:33:46Z"
}

GET /planning_entries

Retrieve all planning entries (paged):

curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/planning_entries?period=2020-04-01:2020-07-31' \
  -H 'Authorization: Token token=YOUR_API_KEY'

This returns an array with complete information about the planning entries (see Attributes).

The following parameters can be supplied:

• Global filters apply
• period – “2020-05-01:2020-07-31”
• user_id – 123
• project_id – 345

GET /planning_entries/{id}

Retrieve a single planning entry:

curl -X GET \
  'https://{domain}.mocoapp.com/api/v1/planning_entries/{id}' \
  -H 'Authorization: Token token=YOUR_API_KEY'

POST /planning_entries

Create a planning entry:

The entry is always created with the user that’s executing the request (authorization token) if no user_id is supplied.

curl -X POST \
  'https://{domain}.mocoapp.com/api/v1/planning_entries' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "project_id": 4322,
        "starts_on": "2020-05-20",
        "ends_on": "2020-05-30",
        "hours_per_day": 3,
        "comment": "A comment...",
        "symbol": 2
      }'

Mandatory fields are marked with a star (*):

• either project_id* or deal_id* – 4322 (project or deal ID)
• starts_on* – “2020-05-20”
• ends_on* – “2020-05-30”
• hours_per_day* – 3
• user_id – 234567 (user ID for active staff)
• comment – “A comment…”
• symbol – 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 (home, building, car, graduation cap, cocktail, bells, baby carriage, users, moon , info circle)

PUT /planning_entries/{id}

Update a planning entry:

curl -X PUT \
  'https://{domain}.mocoapp.com/api/v1/planning_entries/{id}' \
  -H 'Authorization: Token token=YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
        "hours_per_day": 5
      }'

Fields are analogous to the POST request.

DELETE /planning_entries/{id}

curl -X DELETE \
  'https://{domain}.mocoapp.com/api/v1/planning_entries/{id}' \
  -H 'Authorization: Token token=YOUR_API_KEY'