Hoshinplan

API Docs

Tasks

>>>

GET /tasks/:id
Get a task

Ejemplos

curl "https://www.hoshinplan.com/tasks/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Accept: application/json"


Response:
{
    "id": 45544,
    "name": "My task",
    "description": "This is my task created through the API",
    "deadline": "2021-01-03",
    "original_deadline": "2021-01-03",
    "created_at": "2010-10-02T09:47:59.186Z",
    "updated_at": "2010-10-02T10:33:42.326Z",
    "objective_id": 9400,
    "status": "backlog",
    "key_timestamp": null,
    "tsk_pos": 9,
    "area_id": 448231,
    "show_on_parent": null,
    "responsible_id": 253123,
    "company_id": 120,
    "reminder": true,
    "creator_id": null,
    "hoshin_id": 1545,
    "lane_pos": 0,
    "parent_area_id": null,
    "parent_objective_id": null,
    "feeling": "wondering"
}

Respuesta

Código HTTP: 200

Descripción:

OK

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
original_deadline
opcional

Validations:

  • Must be Date.
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
tsk_pos
opcional

Used to sort the tasks in the hoshin view

Validations:

  • Must be a number.
lane_pos
opcional

Used to sort the tasks in the kanban view

Validations:

  • Must be a number.
hoshin_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
area_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this task belongs to

Validations:

  • Must be a number.
creator_id
opcional

The id of the user that created this task

Validations:

  • Must be a number.
objective_id
opcional

The id of the objective this task belongs to

Validations:

  • Must be a number.
responsible_id
opcional

The id of the user that is responsible for this task

Validations:

  • Must be a number.
description
opcional

Validations:

  • Must be a String
deadline
opcional

Validations:

  • Must be Date.
show_on_parent
opcional

Show this task in the parent Hoshin

Validations:

  • Must be one of: true, false, 1, 0.
parent_objective_id
opcional

The id of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
parent_area_id
opcional

The id of the area of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
reminder
opcional

Send email reminders to the owner when the deadline comes

Validations:

  • Must be one of: true, false, 1, 0.
feeling
opcional

How you are feeling about completing this task as planned

Validations:

  • Must be one of: smile, wondering, sad.
status
opcional

Validations:

  • Must be one of: backlog, active, completed, discarded, deleted.
deleted_at
opcional

The date when this task was deleted

Validations:

  • Must be Date.
>>>

POST /objectives/:objective_id/tasks
Create a task for the given objective

Formatos soportados

json, xml

Ejemplos

curl -X POST "https://www.hoshinplan.com/objectives/23423/tasks?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "name": "My new task",
  "description": "This is my task created through the API",
  "responsible_id": 213312,
  "status": "active"
}'

Parámetros

Nombre del parámetro Descripción
name
requerido

Validations:

  • Must be a String
tsk_pos
opcional

Used to sort the tasks in the hoshin view

Validations:

  • Must be a number.
lane_pos
opcional

Used to sort the tasks in the kanban view

Validations:

  • Must be a number.
objective_id
opcional

The id of the objective this task belongs to

Validations:

  • Must be a number.
responsible_id
opcional

The id of the user that is responsible for this task

Validations:

  • Must be a number.
description
opcional

Validations:

  • Must be a String
deadline
opcional

Validations:

  • Must be Date.
show_on_parent
opcional

Show this task in the parent Hoshin

Validations:

  • Must be one of: true, false, 1, 0.
reminder
opcional

Send email reminders to the owner when the deadline comes

Validations:

  • Must be one of: true, false, 1, 0.
feeling
opcional

How you are feeling about completing this task as planned

Validations:

  • Must be one of: smile, wondering, sad.
status
opcional

Validations:

  • Must be one of: backlog, active, completed, discarded, deleted.

Respuesta

Código HTTP: 201

Descripción:

The newly created task

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
original_deadline
opcional

Validations:

  • Must be Date.
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
tsk_pos
opcional

Used to sort the tasks in the hoshin view

Validations:

  • Must be a number.
lane_pos
opcional

Used to sort the tasks in the kanban view

Validations:

  • Must be a number.
hoshin_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
area_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this task belongs to

Validations:

  • Must be a number.
creator_id
opcional

The id of the user that created this task

Validations:

  • Must be a number.
objective_id
opcional

The id of the objective this task belongs to

Validations:

  • Must be a number.
responsible_id
opcional

The id of the user that is responsible for this task

Validations:

  • Must be a number.
description
opcional

Validations:

  • Must be a String
deadline
opcional

Validations:

  • Must be Date.
show_on_parent
opcional

Show this task in the parent Hoshin

Validations:

  • Must be one of: true, false, 1, 0.
parent_objective_id
opcional

The id of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
parent_area_id
opcional

The id of the area of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
reminder
opcional

Send email reminders to the owner when the deadline comes

Validations:

  • Must be one of: true, false, 1, 0.
feeling
opcional

How you are feeling about completing this task as planned

Validations:

  • Must be one of: smile, wondering, sad.
status
opcional

Validations:

  • Must be one of: backlog, active, completed, discarded, deleted.
deleted_at
opcional

The date when this task was deleted

Validations:

  • Must be Date.
>>>

DELETE /tasks/:id
Delete a task

Ejemplos

curl -X DELETE "https://www.hoshinplan.com/tasks/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Accept: application/json"

Respuesta

Código HTTP: 204

Descripción:

No Content

Nombre del parámetro Descripción
>>>

PUT /tasks/:id
Update a task

Formatos soportados

json, xml

Ejemplos

curl -X PUT "https://www.hoshinplan.com/tasks/45544?app_key=<APP_KEY>&timestamp=<TIMESTAMP>&signature=<SIGNATURE>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "status": "completed"
}'

Parámetros

Nombre del parámetro Descripción
name
opcional

Validations:

  • Must be a String
tsk_pos
opcional

Used to sort the tasks in the hoshin view

Validations:

  • Must be a number.
lane_pos
opcional

Used to sort the tasks in the kanban view

Validations:

  • Must be a number.
objective_id
opcional

The id of the objective this task belongs to

Validations:

  • Must be a number.
responsible_id
opcional

The id of the user that is responsible for this task

Validations:

  • Must be a number.
description
opcional

Validations:

  • Must be a String
deadline
opcional

Validations:

  • Must be Date.
show_on_parent
opcional

Show this task in the parent Hoshin

Validations:

  • Must be one of: true, false, 1, 0.
reminder
opcional

Send email reminders to the owner when the deadline comes

Validations:

  • Must be one of: true, false, 1, 0.
feeling
opcional

How you are feeling about completing this task as planned

Validations:

  • Must be one of: smile, wondering, sad.
status
opcional

Validations:

  • Must be one of: backlog, active, completed, discarded, deleted.

Respuesta

Código HTTP: 200

Descripción:

The updated task

Nombre del parámetro Descripción
id
opcional

Validations:

  • Must be a number.
name
opcional

Validations:

  • Must be a String
original_deadline
opcional

Validations:

  • Must be Date.
created_at
opcional

Validations:

  • Must be Date.
updated_at
opcional

Validations:

  • Must be Date.
tsk_pos
opcional

Used to sort the tasks in the hoshin view

Validations:

  • Must be a number.
lane_pos
opcional

Used to sort the tasks in the kanban view

Validations:

  • Must be a number.
hoshin_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
area_id
opcional

The id of the area this task belongs to

Validations:

  • Must be a number.
company_id
opcional

The id of the company this task belongs to

Validations:

  • Must be a number.
creator_id
opcional

The id of the user that created this task

Validations:

  • Must be a number.
objective_id
opcional

The id of the objective this task belongs to

Validations:

  • Must be a number.
responsible_id
opcional

The id of the user that is responsible for this task

Validations:

  • Must be a number.
description
opcional

Validations:

  • Must be a String
deadline
opcional

Validations:

  • Must be Date.
show_on_parent
opcional

Show this task in the parent Hoshin

Validations:

  • Must be one of: true, false, 1, 0.
parent_objective_id
opcional

The id of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
parent_area_id
opcional

The id of the area of the parent objective of the objective this task belongs to

Validations:

  • Must be a number.
reminder
opcional

Send email reminders to the owner when the deadline comes

Validations:

  • Must be one of: true, false, 1, 0.
feeling
opcional

How you are feeling about completing this task as planned

Validations:

  • Must be one of: smile, wondering, sad.
status
opcional

Validations:

  • Must be one of: backlog, active, completed, discarded, deleted.
deleted_at
opcional

The date when this task was deleted

Validations:

  • Must be Date.