meet and rockDeveloper Docs

Task Management API

Use the Task Management API to organize work into boards, columns, and tasks, assign members, and keep your project backlog in sync with Meet and Rock.

Base URL

https://api.meetandrock.com/v1/dev

Authentication

Send your secret API key as a Bearer token in the Authorization header:Authorization: Bearer YOUR_API_KEY

Task Board Management

Create boards for your project, list them, update their details, or delete ones you no longer need.

List Task Boards

Retrieve all task boards for the current project.

GEThttps://api.meetandrock.com/v1/dev/task-boards

List task boards

Fetch all task boards for the current project.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Task Board

Create a new task board to group related work items, like a sprint or product area.

POSThttps://api.meetandrock.com/v1/dev/task-boards

Create task board

Create a new task board for your project.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sprint Board",
    "description": "Q1 2024 Sprint Board"
  }'

Update Task Board

Update an existing task board's name or description.

PUThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId

Update task board

Change a task board's name or description.

curl -X PUT "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Board Name",
    "description": "Updated description"
  }'

Delete Task Board

Permanently delete a task board by its ID.

DELETEhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId

Delete task board

Delete a task board.

curl -X DELETE "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Column Management

Columns represent stages in your workflow (for example, To Do, In Progress, Done) and live inside a task board.

List Columns

Retrieve all columns for a given task board, including order and color.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column

List columns

Fetch all columns for a specific task board.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Column

Add a new column to a board with a display name and order index.

POSThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column

Create column

Create a new column in a task board.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "In Progress",
    "order": 1
  }'

Get Column

Retrieve a single column by its ID.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId

Retrieve column

Get details for a specific board column.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update Column

Change a column's name or order within the board.

PUThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId

Update column

Update the name or order of a column.

curl -X PUT "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Column Name",
    "order": 2
  }'

Move Column

Reorder columns within a board by specifying the from and to positions.

PATCHhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId/move

Move column

Reorder a column within its board.

curl -X PATCH "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId/move" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": 0,
    "to": 2
  }'

Delete Column

Permanently delete a column by its ID.

DELETEhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId

Delete column

Delete a column from a task board.

curl -X DELETE "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/column/:projectColumnId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Task Management

Endpoints for listing, creating, updating, moving, archiving and deleting tasks within a task board.

GET/task-boards/:projectBoardId/task

List tasks

Retrieve all tasks in a task board, including metadata like column, assignee, estimate and status.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task

List tasks

Fetch all tasks for a given task board.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/task-boards/:projectBoardId/task

Create task

Create a new task in a column, optionally linking it to a milestone and assignee.

POSThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task

Create task

Create a task with title, description, estimate and type.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Implement user authentication",
    "description": "Add login and registration functionality",
    "column_id": "uuid",
    "milestone_id": "uuid",
    "assigned_to": "uuid",
    "estimate": 8,
    "type": "feature"
  }'

GET/task-boards/:projectBoardId/task/:taskId

Get task

Retrieve a single task by its ID.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId

Get task

Fetch details for a specific task.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId" \
  -H "Authorization: Bearer YOUR_API_KEY"

PUT/task-boards/:projectBoardId/task/:taskId

Update task

Update an existing task's title, description, assignee or other fields.

PUThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId

Update task

Update the core fields for a task.

curl -X PUT "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Task Title",
    "description": "Updated description",
    "assigned_to": "uuid"
  }'

POST/task-boards/:projectBoardId/task/:taskId/move

Move task

Move a task to a new column and update its position relative to other tasks.

POSThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/move

Move task

Move a task to a different column and reorder.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/move" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "column_id": "uuid",
    "cardIndexes": {
      "task-id-1": 0,
      "task-id-2": 1,
      "task-id-3": 2
    }
  }'

PUT/task-boards/:projectBoardId/task/:taskId/archive

Archive task

Archive a task without permanently deleting it.

PUThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/archive

Archive task

Mark a task as archived.

curl -X PUT "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/archive" \
  -H "Authorization: Bearer YOUR_API_KEY"

DELETE/task-boards/:projectBoardId/task/:taskId

Delete task

Permanently delete a task from the board.

DELETEhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId

Delete task

Delete a task by its unique identifier.

curl -X DELETE "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Task Members & Comments

Endpoints for managing which members are assigned to a task and for adding comments to task activity.

GET/task-boards/:projectBoardId/task/:taskId/member

List task members

Retrieve all members currently assigned to a task.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member

List task members

Get all members assigned to a given task.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/task-boards/:projectBoardId/task/:taskId/member

Add task member

Assign a new member to a task by their member ID.

POSThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member

Add task member

Assign a member to a task.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "member_id": "uuid"
  }'

DELETE/task-boards/:projectBoardId/task/:taskId/member/:taskMemberId

Remove task member

Unassign a member from a task.

DELETEhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member/:taskMemberId

Remove task member

Remove a member from a task.

curl -X DELETE "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/member/:taskMemberId" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/task-boards/:projectBoardId/task/:taskId/comment

List task comments

Retrieve all comments attached to a task.

GEThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment

List task comments

Fetch the comment history for a task.

curl -X GET "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/task-boards/:projectBoardId/task/:taskId/comment

Add task comment

Add a new comment to the task's activity thread.

POSThttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment

Add task comment

Create a new comment on a task.

curl -X POST "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "This looks good!"
  }'

DELETE/task-boards/:projectBoardId/task/:taskId/comment/:taskCommentId

Delete task comment

Remove a specific comment from a task.

DELETEhttps://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment/:taskCommentId

Delete task comment

Delete a comment from a task.

curl -X DELETE "https://api.meetandrock.com/v1/dev/task-boards/:projectBoardId/task/:taskId/comment/:taskCommentId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error responses

Standard error responses for the Task Management API.

400 Bad Request

The request body or query parameters are invalid.

{
  "message": "Invalid request parameters"
}

401 Unauthorized

The API key is missing, expired, or invalid.

{
  "message": "Invalid or missing API key"
}

404 Not Found

The requested task board or task could not be found.

{
  "message": "Task board not found"
}

500 Internal Server Error

An unexpected error occurred while processing the request.

{
  "message": "ProjectBoard create failed"
}

Task Management API

Task Board Management

List Task Boards

Create Task Board

Update Task Board

Delete Task Board

Column Management

List Columns

Create Column

Get Column

Update Column

Move Column

Delete Column

Task Management

List tasks

Create task

Get task

Update task

Move task

Archive task

Delete task

Task Members & Comments

List task members

Add task member

Remove task member

List task comments

Add task comment

Delete task comment

Error responses

Contents