{ "openapi": "3.0.3", "info": { "title": "Akievo Board API", "version": "1.0.0", "description": "The Akievo API provides programmatic access to Kanban boards, lists, cards, and more.\n\n## Authentication\nAll requests require a Bearer token: `Authorization: Bearer akievo_your_api_key`\n\n## Rate Limiting\n1,000 requests per hour per API key.\n\n## Webhooks\nAvailable events: card.created, card.updated, card.deleted, card.moved, card.completed, card.archived, card.blocked, card.unblocked, list.created, list.updated, list.deleted, checklist.created, checklist.deleted, checklist_item.completed, comment.created, comment.deleted, label.assigned, label.unassigned, assignee.added, assignee.removed, member.added, member.removed", "contact": { "email": "api@akievo.com" } }, "servers": [ { "url": "https://hjxidrapzcpgpovymuze.supabase.co/functions/v1", "description": "Production server" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "General", "description": "General API operations" }, { "name": "Boards", "description": "Retrieve and update board information" }, { "name": "Lists", "description": "Manage lists within boards" }, { "name": "Cards", "description": "Create, update, and manage cards" }, { "name": "Labels", "description": "Manage board and card labels" }, { "name": "Assignees", "description": "Manage card assignees" }, { "name": "Checklists", "description": "Manage card checklists" }, { "name": "Checklist Items", "description": "Manage checklist items" }, { "name": "Comments", "description": "Manage card comments" }, { "name": "Attachments", "description": "Manage card attachments" }, { "name": "Members", "description": "Manage board members" }, { "name": "Activities", "description": "View board activity feed" }, { "name": "Webhooks", "description": "Manage webhook endpoints" } ], "paths": { "/board-api#boards.get": { "post": { "operationId": "boards_get", "summary": "Get Board", "description": "Retrieve a board with all its lists and cards", "tags": [ "Boards" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "boards.get" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The unique identifier of the board" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#boards.update": { "post": { "operationId": "boards_update", "summary": "Update Board", "description": "Update board settings like title, description, or visibility", "tags": [ "Boards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "boards.update" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The unique identifier of the board" }, "title": { "type": "string", "description": "New board title" }, "description": { "type": "string", "description": "New board description" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#lists.list": { "post": { "operationId": "lists_list", "summary": "List Lists", "description": "Get all lists in a board", "tags": [ "Lists" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "lists.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#lists.create": { "post": { "operationId": "lists_create", "summary": "Create List", "description": "Create a new list in a board", "tags": [ "Lists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "lists.create" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "title": { "type": "string", "description": "List title" } }, "required": [ "boardId", "title" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#lists.update": { "post": { "operationId": "lists_update", "summary": "Update List", "description": "Update a list title or archive status", "tags": [ "Lists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "lists.update" ] }, "params": { "type": "object", "properties": { "listId": { "type": "string", "format": "uuid", "description": "The list ID" }, "title": { "type": "string", "description": "New list title" } }, "required": [ "listId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#lists.delete": { "post": { "operationId": "lists_delete", "summary": "Delete List", "description": "Permanently delete a list and all its cards", "tags": [ "Lists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "lists.delete" ] }, "params": { "type": "object", "properties": { "listId": { "type": "string", "format": "uuid", "description": "The list ID to delete" } }, "required": [ "listId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#lists.reorder": { "post": { "operationId": "lists_reorder", "summary": "Reorder Lists", "description": "Reorder multiple lists at once", "tags": [ "Lists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "lists.reorder" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "updates": { "type": "array", "items": { "type": "string" }, "description": "Array of {id, position} objects" } }, "required": [ "boardId", "updates" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.list": { "post": { "operationId": "cards_list", "summary": "List Cards", "description": "Get all cards in a board or specific list", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "listId": { "type": "string", "format": "uuid", "description": "Filter by specific list" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.get": { "post": { "operationId": "cards_get", "summary": "Get Card", "description": "Get a single card with all details", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.get" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.create": { "post": { "operationId": "cards_create", "summary": "Create Card", "description": "Create a new card in a list", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.create" ] }, "params": { "type": "object", "properties": { "listId": { "type": "string", "format": "uuid", "description": "The list to add the card to" }, "title": { "type": "string", "description": "Card title" }, "description": { "type": "string", "description": "Card description" }, "priority": { "type": "string", "description": "Priority: low, medium, high, urgent" }, "due_date": { "type": "string", "description": "Due date in ISO 8601 format" }, "is_blocked": { "type": "boolean", "description": "Create card as blocked" }, "blocked_reason": { "type": "string", "description": "Reason for blocking (if is_blocked is true)" } }, "required": [ "listId", "title" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.update": { "post": { "operationId": "cards_update", "summary": "Update Card", "description": "Update card properties", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.update" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "title": { "type": "string", "description": "New card title" }, "description": { "type": "string", "description": "New description" }, "priority": { "type": "string", "description": "Priority level" }, "is_blocked": { "type": "boolean", "description": "Mark card as blocked or unblocked" }, "blocked_reason": { "type": "string", "description": "Reason for blocking" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.block": { "post": { "operationId": "cards_block", "summary": "Block Card", "description": "Mark a card as blocked with an optional reason", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.block" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "reason": { "type": "string", "description": "Reason for blocking" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.unblock": { "post": { "operationId": "cards_unblock", "summary": "Unblock Card", "description": "Clear the blocked status from a card", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.unblock" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.delete": { "post": { "operationId": "cards_delete", "summary": "Delete Card", "description": "Remove a card from the board (cards are archived and can be restored from the web app)", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.delete" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID to delete" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.move": { "post": { "operationId": "cards_move", "summary": "Move Card", "description": "Move a card to a different list or position", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.move" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "listId": { "type": "string", "format": "uuid", "description": "Target list ID" }, "position": { "type": "number", "description": "Position in the target list" } }, "required": [ "cardId", "listId", "position" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#cards.complete": { "post": { "operationId": "cards_complete", "summary": "Toggle Card Completion", "description": "Mark a card as complete or incomplete", "tags": [ "Cards" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "cards.complete" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "completed": { "type": "boolean", "description": "Completion status" } }, "required": [ "cardId", "completed" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#labels.list": { "post": { "operationId": "labels_list", "summary": "List Labels", "description": "Get all labels defined on a board", "tags": [ "Labels" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "labels.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#labels.create": { "post": { "operationId": "labels_create", "summary": "Create Label", "description": "Create a new label on a board", "tags": [ "Labels" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "labels.create" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "color": { "type": "string", "description": "Label color" }, "name": { "type": "string", "description": "Label name" } }, "required": [ "boardId", "color" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#labels.assign": { "post": { "operationId": "labels_assign", "summary": "Assign Label to Card", "description": "Add a label to a card", "tags": [ "Labels" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "labels.assign" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "labelId": { "type": "string", "format": "uuid", "description": "The label ID to assign" } }, "required": [ "cardId", "labelId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#labels.unassign": { "post": { "operationId": "labels_unassign", "summary": "Remove Label from Card", "description": "Remove a label from a card", "tags": [ "Labels" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "labels.unassign" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "labelId": { "type": "string", "format": "uuid", "description": "The label ID to remove" } }, "required": [ "cardId", "labelId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#assignees.list": { "post": { "operationId": "assignees_list", "summary": "List Card Assignees", "description": "Get all users assigned to a card", "tags": [ "Assignees" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "assignees.list" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#assignees.add": { "post": { "operationId": "assignees_add", "summary": "Add Assignee", "description": "Assign a user to a card", "tags": [ "Assignees" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "assignees.add" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "userId": { "type": "string", "format": "uuid", "description": "The user ID to assign" } }, "required": [ "cardId", "userId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#assignees.remove": { "post": { "operationId": "assignees_remove", "summary": "Remove Assignee", "description": "Remove a user from a card", "tags": [ "Assignees" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "assignees.remove" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "userId": { "type": "string", "format": "uuid", "description": "The user ID to remove" } }, "required": [ "cardId", "userId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#checklists.list": { "post": { "operationId": "checklists_list", "summary": "List Checklists", "description": "Get all checklists on a card", "tags": [ "Checklists" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "checklists.list" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#checklists.create": { "post": { "operationId": "checklists_create", "summary": "Create Checklist", "description": "Add a new checklist to a card", "tags": [ "Checklists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "checklists.create" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "title": { "type": "string", "description": "Checklist title" } }, "required": [ "cardId", "title" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#checklists.delete": { "post": { "operationId": "checklists_delete", "summary": "Delete Checklist", "description": "Delete a checklist and all its items", "tags": [ "Checklists" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "checklists.delete" ] }, "params": { "type": "object", "properties": { "checklistId": { "type": "string", "format": "uuid", "description": "The checklist ID" } }, "required": [ "checklistId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#checklist_items.create": { "post": { "operationId": "checklist_items_create", "summary": "Create Checklist Item", "description": "Add a new item to a checklist", "tags": [ "Checklist Items" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "checklist_items.create" ] }, "params": { "type": "object", "properties": { "checklistId": { "type": "string", "format": "uuid", "description": "The checklist ID" }, "text": { "type": "string", "description": "Item text" } }, "required": [ "checklistId", "text" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#checklist_items.update": { "post": { "operationId": "checklist_items_update", "summary": "Update Checklist Item", "description": "Update item text or completion status", "tags": [ "Checklist Items" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "checklist_items.update" ] }, "params": { "type": "object", "properties": { "itemId": { "type": "string", "format": "uuid", "description": "The item ID" }, "is_complete": { "type": "boolean", "description": "Completion status" } }, "required": [ "itemId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#comments.list": { "post": { "operationId": "comments_list", "summary": "List Comments", "description": "Get all comments on a card", "tags": [ "Comments" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "comments.list" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" } }, "required": [ "cardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#comments.create": { "post": { "operationId": "comments_create", "summary": "Create Comment", "description": "Add a comment to a card", "tags": [ "Comments" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "comments.create" ] }, "params": { "type": "object", "properties": { "cardId": { "type": "string", "format": "uuid", "description": "The card ID" }, "content": { "type": "string", "description": "Comment content" } }, "required": [ "cardId", "content" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#comments.delete": { "post": { "operationId": "comments_delete", "summary": "Delete Comment", "description": "Delete a comment (must be the author)", "tags": [ "Comments" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "comments.delete" ] }, "params": { "type": "object", "properties": { "commentId": { "type": "string", "format": "uuid", "description": "The comment ID to delete" } }, "required": [ "commentId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#members.list": { "post": { "operationId": "members_list", "summary": "List Board Members", "description": "Get all members of a board", "tags": [ "Members" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "members.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#activities.list": { "post": { "operationId": "activities_list", "summary": "List Activities", "description": "Get the activity feed for a board", "tags": [ "Activities" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "activities.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "limit": { "type": "number", "description": "Number of activities to return" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#webhooks.list": { "post": { "operationId": "webhooks_list", "summary": "List Webhooks", "description": "Get all webhooks configured for a board", "tags": [ "Webhooks" ], "security": [ { "bearerAuth": [] } ], "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "webhooks.list" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" } }, "required": [ "boardId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#webhooks.create": { "post": { "operationId": "webhooks_create", "summary": "Create Webhook", "description": "Create a new webhook endpoint for a board", "tags": [ "Webhooks" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "webhooks.create" ] }, "params": { "type": "object", "properties": { "boardId": { "type": "string", "format": "uuid", "description": "The board ID" }, "name": { "type": "string", "description": "Webhook name" }, "url": { "type": "string", "description": "HTTPS URL" }, "events": { "type": "array", "items": { "type": "string" }, "description": "Event types to subscribe" } }, "required": [ "boardId", "name", "url", "events" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api#webhooks.delete": { "post": { "operationId": "webhooks_delete", "summary": "Delete Webhook", "description": "Delete a webhook endpoint", "tags": [ "Webhooks" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "webhooks.delete" ] }, "params": { "type": "object", "properties": { "webhookId": { "type": "string", "format": "uuid", "description": "The webhook ID to delete" } }, "required": [ "webhookId" ] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object" } } } } } }, "401": { "description": "Unauthorized" }, "429": { "description": "Rate limit exceeded" } } } }, "/board-api": { "post": { "operationId": "executeAction", "summary": "Execute API Action", "description": "Execute any API action through this single endpoint", "tags": [ "General" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "action", "params" ], "properties": { "action": { "type": "string", "enum": [ "boards.get", "boards.update", "lists.list", "lists.create", "lists.update", "lists.delete", "lists.reorder", "cards.list", "cards.get", "cards.create", "cards.update", "cards.block", "cards.unblock", "cards.delete", "cards.move", "cards.complete", "labels.list", "labels.create", "labels.assign", "labels.unassign", "assignees.list", "assignees.add", "assignees.remove", "checklists.list", "checklists.create", "checklists.delete", "checklist_items.create", "checklist_items.update", "comments.list", "comments.create", "comments.delete", "members.list", "activities.list", "webhooks.list", "webhooks.create", "webhooks.delete" ] }, "params": { "type": "object" } } } } } }, "responses": { "200": { "description": "Successful response" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API Key", "description": "API key starting with akievo_" } }, "schemas": { "Error": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ false ] }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } } } }