Hlix Attention API
The attention API from Hlix — 1 operation(s) for attention.
The attention API from Hlix — 1 operation(s) for attention.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/hlix-ai:hlix-ai-attention-api"
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.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: Explore the Hlix API for projects, agent teams, and delivery workflows. Authenticate with `x-api-key` and select a Workspace with `X-Organization-Id`. Session-only operations require a signed-in user session. Authentication setup.
title: reference Attention API
version: 1.0.0
servers:
- url: https://server.hlix.ai
description: API server
security:
- apiKey: []
- sessionCookie: []
tags:
- name: attention
paths:
/v1/api/attention:
get:
operationId: getAttentionInbox
parameters:
- description: Page size, clamped to 1–500; 100 when omitted or not an integer.
in: query
name: limit
required: false
schema:
type: string
- description: Items to skip, most urgent kind first and newest first within a kind. `total` and `countsByKind` count every item, so they say how many pages there are.
in: query
name: offset
required: false
schema:
type: string
- $ref: '#/components/parameters/OrganizationId'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AttentionSummary'
description: One page of open items, their total count and whether that count is exact. When `truncated` is true, `total` is a lower bound.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: The request named no active organization.
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: No valid session or API key.
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: The caller is a client collaborator; the attention inbox is agency-only. (Or the caller is not a member of this workspace at all.)
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
description: The resource does not exist, or the caller is a task-scoped credential and this endpoint is outside its allowlist.
summary: Get the operator attention inbox
tags:
- attention
components:
schemas:
ApiError:
additionalProperties: {}
properties:
error:
type: string
required:
- error
type: object
AttentionSummary:
properties:
countsByKind:
properties:
alerts.broken:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
delivery.unknown:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
mention.unread:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
reply.interested:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
request.pending:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
review.unresolved:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
run.failed:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
secrets.vault_unreachable:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
type: object
items:
items:
properties:
cycleId:
type:
- string
- 'null'
detail:
type:
- string
- 'null'
id:
type: string
kind:
enum:
- run.failed
- request.pending
- review.unresolved
- mention.unread
- reply.interested
- delivery.unknown
- alerts.broken
- secrets.vault_unreachable
type: string
leadId:
type: string
occurredAt:
type: string
projectId:
type:
- string
- 'null'
projectName:
type:
- string
- 'null'
source:
properties:
id:
type: string
kind:
enum:
- agent_run
- pending_request
- review_comment
- message_mention
- gtm_message
- alert_route
- secrets_config
type: string
required:
- kind
- id
type: object
subject:
type:
- string
- 'null'
taskId:
type:
- string
- 'null'
taskName:
type:
- string
- 'null'
title:
type: string
vault:
properties:
expiresAt:
type:
- string
- 'null'
savedAt:
type:
- string
- 'null'
required:
- savedAt
- expiresAt
type: object
required:
- id
- kind
- projectId
- projectName
- cycleId
- taskId
- taskName
- subject
- title
- detail
- occurredAt
- source
type: object
type: array
total:
maximum: 9007199254740991
minimum: -9007199254740991
type: integer
truncated:
type: boolean
required:
- items
- total
- countsByKind
- truncated
type: object
parameters:
OrganizationId:
description: The workspace (organization) to act in. Omitted, the session's active organization is used.
in: header
name: X-Organization-Id
required: false
schema:
type: string
example: YOUR_WORKSPACE_ID
securitySchemes:
apiKey:
description: An API key issued through `/v1/api/auth/api-key/*`. Browser clients can use their session cookie instead.
in: header
name: x-api-key
type: apiKey
sessionCookie:
description: The complete session Cookie header issued by sign-in at the selected API host. Cookie names vary by hosting region and environment; preserve the issued name and value. Browsers send these HTTP-only cookies automatically. Session-only operations require this user session and do not accept an API key.
in: header
name: Cookie
type: apiKey