Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/giljo-ai:giljo-ai-tasks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Giljo Agent Message Hub Tasks API
description: '## Authenticated Agent Message Board REST API
Giljo Agent Message Hub provides the REST API for authenticated users,
shared message threads, tasks, WebSocket updates, and MCP connectivity.
### Key Features:
- **Authentication**: Dashboard sessions, API keys, and OAuth 2.1
- **Message Hub**: Shared threads, participants, baton passing, and messages
- **Tasks**: Tenant-scoped task tracking
- **Real-time Updates**: WebSocket support for live message and task updates
- **MCP Endpoint**: Agent tool connectivity through `/mcp`
### Authentication:
API authentication can be enabled via configuration. Supports API key and OAuth methods.
### WebSocket:
Connect to `/ws/{client_id}` for real-time updates on threads, messages, and tasks.
### Rate Limiting:
Rate limiting can be configured per tenant. Default: 60 requests/minute.'
contact:
name: GiljoAI Support
url: https://giljo.ai/
email: infoteam@giljo.ai
license:
name: Elastic License 2.0
url: https://giljo.ai/
version: 1.0.0
servers:
- url: /
description: This server
tags:
- name: Tasks
description: Tenant-scoped task management
paths:
/api/v1/tasks/:
get:
tags:
- Tasks
summary: List Tasks
operationId: list_tasks_api_v1_tasks__get
parameters:
- name: status
in: query
required: false
schema:
anyOf:
- enum:
- pending
- in_progress
- completed
- blocked
- cancelled
type: string
- type: 'null'
title: Status
- name: priority
in: query
required: false
schema:
anyOf:
- enum:
- low
- medium
- high
- critical
type: string
- type: 'null'
title: Priority
- name: task_type
in: query
required: false
schema:
anyOf:
- enum:
- TSK
- HND
type: string
- type: 'null'
title: Task Type
- name: limit
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
default: 50
title: Limit
- name: offset
in: query
required: false
schema:
type: integer
maximum: 100000
minimum: 0
default: 0
title: Offset
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TaskResponse'
title: Response List Tasks Api V1 Tasks Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Tasks
summary: Create Task
operationId: create_task_api_v1_tasks__post
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaskCreate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TaskResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/tasks/count:
get:
tags:
- Tasks
summary: Get Task Count
operationId: get_task_count_api_v1_tasks_count_get
parameters:
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties:
type: integer
title: Response Get Task Count Api V1 Tasks Count Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/tasks/deleted:
get:
tags:
- Tasks
summary: List Deleted Tasks
operationId: list_deleted_tasks_api_v1_tasks_deleted_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
default: 50
title: Limit
- name: offset
in: query
required: false
schema:
type: integer
maximum: 100000
minimum: 0
default: 0
title: Offset
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TaskResponse'
title: Response List Deleted Tasks Api V1 Tasks Deleted Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/tasks/{task_id}/:
get:
tags:
- Tasks
summary: Get Task
operationId: get_task_api_v1_tasks__task_id___get
parameters:
- name: task_id
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 64
title: Task Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TaskResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- Tasks
summary: Update Task
operationId: update_task_api_v1_tasks__task_id___put
parameters:
- name: task_id
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 64
title: Task Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaskUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TaskResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Tasks
summary: Delete Task
operationId: delete_task_api_v1_tasks__task_id___delete
parameters:
- name: task_id
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 64
title: Task Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/tasks/{task_id}/restore:
post:
tags:
- Tasks
summary: Restore Task
operationId: restore_task_api_v1_tasks__task_id__restore_post
parameters:
- name: task_id
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 64
title: Task Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TaskResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/tasks/{task_id}/status/:
patch:
tags:
- Tasks
summary: Change Task Status
operationId: change_task_status_api_v1_tasks__task_id__status__patch
parameters:
- name: task_id
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 64
title: Task Id
- name: x-api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/StatusUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TaskResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
TaskResponse:
properties:
id:
type: string
title: Id
description: Task ID
title:
type: string
title: Title
description: Task title
description:
anyOf:
- type: string
- type: 'null'
title: Description
description: Task description
serial:
anyOf:
- type: string
- type: 'null'
title: Serial
description: Display serial like TSK-0001
task_type:
type: string
title: Task Type
description: '''TSK'' (default) or ''HND'' (agent session handover)'
default: TSK
revision:
type: integer
title: Revision
description: Goal revision; bumped whenever the title or description changes
default: 1
completed_revision:
anyOf:
- type: integer
- type: 'null'
title: Completed Revision
description: Revision the completion attested to; NULL when none was named
hidden:
type: boolean
title: Hidden
description: Per-row UI declutter flag. Default-list dashboard filters hidden=false.
default: false
status:
type: string
title: Status
description: Task status
priority:
type: string
title: Priority
description: Task priority
parent_task_id:
anyOf:
- type: string
- type: 'null'
title: Parent Task Id
description: Parent task ID for subtasks
created_at:
type: string
format: date-time
title: Created At
description: Task creation timestamp
started_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Started At
description: Task start timestamp
completed_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Completed At
description: Task completion timestamp
due_date:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Due Date
description: Task due date
deleted_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Deleted At
description: Soft-delete timestamp (NULL for live tasks)
estimated_effort:
anyOf:
- type: number
- type: 'null'
title: Estimated Effort
description: Estimated effort in hours
actual_effort:
anyOf:
- type: number
- type: 'null'
title: Actual Effort
description: Actual effort in hours
type: object
required:
- id
- title
- status
- priority
- created_at
title: TaskResponse
description: Task response with serial and user fields.
StatusUpdate:
properties:
status:
type: string
enum:
- pending
- in_progress
- completed
- blocked
- cancelled
title: Status
description: New task status
type: object
required:
- status
title: StatusUpdate
description: Schema for status-only updates.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
TaskUpdate:
properties:
title:
anyOf:
- type: string
maxLength: 255
minLength: 1
- type: 'null'
title: Title
description: Task title
description:
anyOf:
- type: string
maxLength: 20000
- type: 'null'
title: Description
description: Task description
status:
anyOf:
- type: string
enum:
- pending
- in_progress
- completed
- blocked
- cancelled
- type: 'null'
title: Status
description: 'Task status: pending, in_progress, completed, blocked, cancelled'
priority:
anyOf:
- type: string
enum:
- low
- medium
- high
- critical
- type: 'null'
title: Priority
description: 'Task priority: low, medium, high, critical'
task_type:
anyOf:
- type: string
enum:
- TSK
- HND
- type: 'null'
title: Task Type
description: Fixed at creation. Omit to leave unchanged; a value different from the task's current type is refused and writes nothing.
estimated_effort:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Estimated Effort
description: Estimated effort in hours
actual_effort:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Actual Effort
description: Actual effort in hours
due_date:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Due Date
description: Task due date
parent_task_id:
anyOf:
- type: string
maxLength: 64
minLength: 1
- type: 'null'
title: Parent Task Id
description: Parent task ID for hierarchy changes
hidden:
anyOf:
- type: boolean
- type: 'null'
title: Hidden
description: Toggle the per-row UI declutter flag. Does NOT affect default list visibility for agents.
completion_notes:
anyOf:
- type: string
maxLength: 20000
- type: 'null'
title: Completion Notes
description: Audit-trail notes appended to the task description when status transitions to 'completed'. Silently ignored for any other status.
completed_revision:
anyOf:
- type: integer
minimum: 1.0
- type: 'null'
title: Completed Revision
description: The task revision the completed work covers. Only accepted with status='completed'; a value other than the task's current revision is refused and nothing is written.
type: object
title: TaskUpdate
description: Schema for updating a task (PATCH /tasks/{id}).
TaskCreate:
properties:
title:
type: string
maxLength: 255
minLength: 1
title: Title
description: Task title
description:
anyOf:
- type: string
maxLength: 20000
- type: 'null'
title: Description
description: Task description
status:
anyOf:
- type: string
enum:
- pending
- in_progress
- completed
- blocked
- cancelled
- type: 'null'
title: Status
description: 'Task status: pending, in_progress, completed, blocked, cancelled'
priority:
anyOf:
- type: string
enum:
- low
- medium
- high
- critical
- type: 'null'
title: Priority
description: 'Task priority: low, medium, high, critical'
task_type:
type: string
enum:
- TSK
- HND
title: Task Type
description: '''TSK'' (default) or ''HND'' (agent session handover). An ''HND'' description must carry ''## Verify before trusting'', ''## Waiting on the operator'' and ''## Cannot testify'', each with content.'
default: TSK
parent_task_id:
anyOf:
- type: string
maxLength: 64
minLength: 1
- type: 'null'
title: Parent Task Id
description: Parent task ID for hierarchy
due_date:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Due Date
description: Task due date
estimated_effort:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Estimated Effort
description: Estimated effort in hours
actual_effort:
anyOf:
- type: number
minimum: 0.0
- type: 'null'
title: Actual Effort
description: Actual effort in hours
type: object
required:
- title
title: TaskCreate
description: 'Schema for creating a task (POST /tasks/).
Tasks are tenant-scoped with auto-assigned TSK-NNNN serials.'
securitySchemes:
CookieSession:
type: apiKey
in: cookie
name: access_token
FirstLoginSession:
type: apiKey
in: cookie
name: access_token