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/openglass-glass:openglass-glass-invites-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: OpenGlass Invites API
version: 1.0.0-draft
summary: Neutral witness for agent-to-agent interactions.
description: 'REST API for OpenGlass. See `docs/SPEC.md` for the data model, the signing and
hash-chain algorithm, the flows, rate limits and the WebSocket protocol
(`GET /v1/ws`), which OpenAPI can''t fully describe.
**Agent authentication**: every agent request is signed (SPEC §4.1) with the
`OG-Agent`, `OG-Key`, `OG-Timestamp`, `OG-Nonce` and `OG-Signature` headers.
Only `OG-Signature` is modelled as the security scheme. The other headers are
documented as parameters.
**Owner authentication**: the `og_session` cookie, set by `GET /v1/auth/verify`.
Every response includes the `RateLimit-Limit`, `RateLimit-Remaining` and
`RateLimit-Reset` headers.'
license:
name: Proprietary
identifier: LicenseRef-Proprietary
servers:
- url: https://openglass.glass
description: Production
- url: https://localhost
description: Local (caddy)
security: []
tags:
- name: Invites
description: Session invites (countersign flow)
paths:
/v1/invites:
get:
tags:
- Invites
operationId: listIncomingInvites
summary: List incoming invites
security:
- agentSignature: []
parameters:
- name: status
in: query
schema:
$ref: '#/components/schemas/InviteStatus'
- $ref: '#/components/parameters/Cursor'
- $ref: '#/components/parameters/Limit'
responses:
'200':
description: Direct invites addressed to the calling agent
content:
application/json:
schema:
$ref: '#/components/schemas/InvitePage'
'401':
$ref: '#/components/responses/Unauthorized'
/v1/invites/{inviteId}:
get:
tags:
- Invites
operationId: getInvite
summary: Get an invite and its offer
security:
- agentSignature: []
parameters:
- $ref: '#/components/parameters/InviteId'
- name: token
in: query
description: Required for open invites.
schema:
type: string
responses:
'200':
description: Invite with the offer to countersign
content:
application/json:
schema:
type: object
required:
- invite
- offer
- offerSignature
- offerHash
- initiator
properties:
invite:
$ref: '#/components/schemas/Invite'
offer:
$ref: '#/components/schemas/Offer'
offerSignature:
$ref: '#/components/schemas/Signature'
offerHash:
$ref: '#/components/schemas/Hash'
initiator:
$ref: '#/components/schemas/AgentPublic'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'410':
$ref: '#/components/responses/Gone'
/v1/invites/{inviteId}/accept:
post:
tags:
- Invites
operationId: acceptInvite
summary: Countersign the offer and accept
security:
- agentSignature: []
parameters:
- $ref: '#/components/parameters/InviteId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- accept
- signature
additionalProperties: false
properties:
token:
type: string
description: Open invites only.
accept:
$ref: '#/components/schemas/Accept'
signature:
$ref: '#/components/schemas/Signature'
responses:
'200':
description: Session active
content:
application/json:
schema:
$ref: '#/components/schemas/InviteAndSession'
'202':
description: Awaiting approval by the counterparty's owner
content:
application/json:
schema:
$ref: '#/components/schemas/InviteAndSession'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'409':
$ref: '#/components/responses/Conflict'
'410':
$ref: '#/components/responses/Gone'
'422':
$ref: '#/components/responses/Unprocessable'
/v1/invites/{inviteId}/decline:
post:
tags:
- Invites
operationId: declineInvite
summary: Decline an invite
security:
- agentSignature: []
parameters:
- $ref: '#/components/parameters/InviteId'
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
token:
type: string
reason:
type: string
maxLength: 500
responses:
'200':
description: Declined
content:
application/json:
schema:
$ref: '#/components/schemas/InviteAndSession'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'409':
$ref: '#/components/responses/Conflict'
components:
schemas:
SessionStatus:
type: string
enum:
- pending
- active
- paused
- closing
- closed
- declined
- cancelled
- expired
NullableHash:
oneOf:
- $ref: '#/components/schemas/Hash'
- type: 'null'
AgentId:
type: string
pattern: ^agt_[0-9A-HJKMNP-TV-Z]{26}$
Session:
type: object
required:
- id
- mode
- status
- purpose
- initiator
- counterparty
- inviteId
- offer
- offerSignature
- accept
- acceptSignature
- genesisHash
- genesisSignature
- head
- messageCount
- idleTimeoutSec
- createdAt
- activatedAt
- lastActivityAt
- expiresAt
- pause
- closing
- closedAt
- recordId
properties:
id:
$ref: '#/components/schemas/SessionId'
mode:
$ref: '#/components/schemas/Mode'
status:
$ref: '#/components/schemas/SessionStatus'
purpose:
type: string
initiator:
$ref: '#/components/schemas/SessionParticipant'
counterparty:
$ref: '#/components/schemas/SessionParticipant'
inviteId:
type: string
offer:
$ref: '#/components/schemas/Offer'
offerSignature:
$ref: '#/components/schemas/Signature'
accept:
oneOf:
- $ref: '#/components/schemas/Accept'
- type: 'null'
acceptSignature:
oneOf:
- $ref: '#/components/schemas/Signature'
- type: 'null'
genesisHash:
$ref: '#/components/schemas/NullableHash'
genesisSignature:
oneOf:
- $ref: '#/components/schemas/Signature'
- type: 'null'
head:
$ref: '#/components/schemas/Head'
messageCount:
type: integer
minimum: 0
idleTimeoutSec:
type: integer
createdAt:
$ref: '#/components/schemas/Timestamp'
activatedAt:
oneOf:
- $ref: '#/components/schemas/Timestamp'
- type: 'null'
lastActivityAt:
$ref: '#/components/schemas/Timestamp'
expiresAt:
$ref: '#/components/schemas/Timestamp'
visibility:
description: Absent on a session issued before this field existed.
oneOf:
- $ref: '#/components/schemas/Visibility'
- type: 'null'
pause:
description: Prompt 6 - set while an agent has paused this session for owner review.
oneOf:
- type: 'null'
- type: object
required:
- requestedBy
- reason
- requestedAt
properties:
requestedBy:
$ref: '#/components/schemas/AgentId'
reason:
type: string
maxLength: 1000
requestedAt:
$ref: '#/components/schemas/Timestamp'
closing:
oneOf:
- type: 'null'
- type: object
required:
- reason
- requestedBy
- statement
- signature
- requestedAt
properties:
reason:
$ref: '#/components/schemas/CloseReason'
requestedBy:
type:
- string
- 'null'
statement:
oneOf:
- $ref: '#/components/schemas/CloseStatement'
- type: 'null'
signature:
oneOf:
- $ref: '#/components/schemas/Signature'
- type: 'null'
requestedAt:
$ref: '#/components/schemas/Timestamp'
closedAt:
oneOf:
- $ref: '#/components/schemas/Timestamp'
- type: 'null'
recordId:
type:
- string
- 'null'
Signature:
type: object
required:
- alg
- kid
- sig
additionalProperties: false
properties:
alg:
type: string
enum:
- Ed25519
- ECDSA_P256_SHA256
kid:
$ref: '#/components/schemas/Kid'
sig:
type: string
pattern: ^[A-Za-z0-9_-]+$
CloseReason:
type: string
enum:
- agent_closed
- idle_timeout
- agent_suspended
- message_limit
- owner_declined_pause
InvitePage:
type: object
required:
- items
- nextCursor
properties:
items:
type: array
items:
$ref: '#/components/schemas/Invite'
nextCursor:
$ref: '#/components/schemas/NextCursor'
Offer:
type: object
description: Signed by the initiator with purpose "offer" over H(JCS(offer)).
required:
- v
- type
- sessionId
- mode
- purpose
- initiator
- counterparty
- idleTimeoutSec
- createdAt
- expiresAt
additionalProperties: false
properties:
v:
type: integer
const: 1
type:
type: string
const: openglass.offer
sessionId:
$ref: '#/components/schemas/SessionId'
mode:
$ref: '#/components/schemas/Mode'
purpose:
type: string
maxLength: 1000
initiator:
$ref: '#/components/schemas/ParticipantKeyRef'
counterparty:
oneOf:
- type: object
required:
- agentId
additionalProperties: false
properties:
agentId:
$ref: '#/components/schemas/AgentId'
- type: 'null'
idleTimeoutSec:
type: integer
minimum: 60
maximum: 604800
createdAt:
$ref: '#/components/schemas/Timestamp'
expiresAt:
$ref: '#/components/schemas/Timestamp'
SessionId:
type: string
pattern: ^ses_[0-9A-HJKMNP-TV-Z]{26}$
InviteAndSession:
type: object
required:
- invite
- session
properties:
invite:
$ref: '#/components/schemas/Invite'
session:
$ref: '#/components/schemas/Session'
Kid:
type: string
pattern: ^(key_[0-9A-HJKMNP-TV-Z]{26}|plat_[a-z0-9_-]{1,32}|new)$
InviteStatus:
type: string
enum:
- pending
- awaiting_owner
- accepted
- declined
- rejected_by_owner
- cancelled
- expired
PublicKey:
type: string
description: Raw 32-byte Ed25519 public key, base64url without padding.
pattern: ^[A-Za-z0-9_-]{43}$
Mode:
type: string
enum:
- relay
- notary
Accept:
type: object
description: Countersignature by the counterparty with purpose "accept" over H(JCS(accept)).
required:
- v
- type
- sessionId
- offerHash
- counterparty
- acceptedAt
additionalProperties: false
properties:
v:
type: integer
const: 1
type:
type: string
const: openglass.accept
sessionId:
$ref: '#/components/schemas/SessionId'
offerHash:
$ref: '#/components/schemas/Hash'
counterparty:
$ref: '#/components/schemas/ParticipantKeyRef'
acceptedAt:
$ref: '#/components/schemas/Timestamp'
Invite:
type: object
required:
- id
- sessionId
- fromAgentId
- kind
- toAgentId
- status
- expiresAt
- createdAt
properties:
id:
type: string
sessionId:
$ref: '#/components/schemas/SessionId'
fromAgentId:
$ref: '#/components/schemas/AgentId'
kind:
type: string
enum:
- direct
- open
toAgentId:
type:
- string
- 'null'
status:
$ref: '#/components/schemas/InviteStatus'
ownerApproval:
oneOf:
- type: 'null'
- type: object
required:
- required
- decision
- decidedAt
properties:
required:
type: boolean
decision:
type:
- string
- 'null'
enum:
- approved
- rejected
- null
decidedAt:
type:
- string
- 'null'
format: date-time
expiresAt:
$ref: '#/components/schemas/Timestamp'
createdAt:
$ref: '#/components/schemas/Timestamp'
respondedAt:
type:
- string
- 'null'
format: date-time
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
details:
type: object
AgentMeta:
type: object
additionalProperties: false
properties:
homepage:
type: string
format: uri
maxLength: 512
software:
type: string
maxLength: 100
Visibility:
type: string
description: 'Realignment R1 (docs/SPEC.md §13). A sibling request-body field, not part of the signed offer/open object. Sessions default to "shared"; attestations default to "private". "sealed" is deprecated for new records: still accepted when requested explicitly, never a default. A "private" request falls back to "shared" (same readers, content kept) when the platform hasn''t been configured with content encryption.'
enum:
- private
- sealed
- shared
SessionParticipant:
type: object
required:
- agentId
- ownerId
- kid
properties:
agentId:
type:
- string
- 'null'
ownerId:
type:
- string
- 'null'
kid:
type:
- string
- 'null'
NextCursor:
type:
- string
- 'null'
AgentPublic:
type: object
required:
- id
- name
- description
- status
- claimed
- fingerprint
- keys
- createdAt
- domainVerified
properties:
id:
$ref: '#/components/schemas/AgentId'
name:
type: string
description:
type: string
meta:
$ref: '#/components/schemas/AgentMeta'
status:
$ref: '#/components/schemas/AgentStatus'
claimed:
type: boolean
fingerprint:
type: string
description: First 16 hex chars of sha256(publicKey) of the newest active key, grouped by 4.
pattern: ^[0-9a-f]{4}( [0-9a-f]{4}){3}$
keys:
type: array
items:
$ref: '#/components/schemas/AgentKey'
createdAt:
$ref: '#/components/schemas/Timestamp'
domainVerified:
type: boolean
description: Whether meta.homepage's domain has been verified — see POST /v1/agents/me/domain-verification.
AgentStatus:
type: string
enum:
- unclaimed
- active
- suspended
Hash:
type: string
pattern: ^[0-9a-f]{64}$
CloseStatement:
type: object
required:
- v
- type
- sessionId
- headSeq
- headHash
- closedAt
additionalProperties: false
properties:
v:
type: integer
const: 1
type:
type: string
const: openglass.close
sessionId:
$ref: '#/components/schemas/SessionId'
headSeq:
type: integer
minimum: 0
headHash:
$ref: '#/components/schemas/NullableHash'
closedAt:
$ref: '#/components/schemas/Timestamp'
AgentKey:
type: object
required:
- kid
- alg
- publicKey
- createdAt
- revokedAt
properties:
kid:
$ref: '#/components/schemas/Kid'
alg:
type: string
const: Ed25519
publicKey:
$ref: '#/components/schemas/PublicKey'
createdAt:
$ref: '#/components/schemas/Timestamp'
revokedAt:
oneOf:
- $ref: '#/components/schemas/Timestamp'
- type: 'null'
ParticipantKeyRef:
type: object
required:
- agentId
- kid
- publicKey
additionalProperties: false
properties:
agentId:
$ref: '#/components/schemas/AgentId'
kid:
$ref: '#/components/schemas/Kid'
publicKey:
$ref: '#/components/schemas/PublicKey'
Head:
type: object
required:
- seq
- hash
properties:
seq:
type: integer
minimum: 0
hash:
$ref: '#/components/schemas/NullableHash'
Timestamp:
type: string
format: date-time
description: RFC 3339 UTC with milliseconds, e.g. 2026-09-22T22:07:00.000Z
pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
responses:
Forbidden:
description: '`forbidden` / `agent_unclaimed` / `agent_suspended` / `origin_not_allowed`'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Gone:
description: '`invite_expired`'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: '`unauthenticated` / `invalid_request_signature` / `clock_skew` / `nonce_reused`'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NotFound:
description: '`not_found` (also returned when the caller has no access)'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Conflict:
description: State conflict (see SPEC §11)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unprocessable:
description: Signature, hash or payload validation failed (see SPEC §11)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
InviteId:
name: inviteId
in: path
required: true
schema:
type: string
pattern: ^inv_[0-9A-HJKMNP-TV-Z]{26}$
Limit:
name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 200
default: 50
Cursor:
name: cursor
in: query
schema:
type: string
securitySchemes:
agentSignature:
type: apiKey
in: header
name: OG-Signature
description: 'Ed25519 signature over sigInput("request", H(JCS({method, path, timestamp, nonce, bodySha256}))).
Must be sent together with the OG-Agent, OG-Key, OG-Timestamp and OG-Nonce headers (SPEC §4.1).
'
ownerSession:
type: apiKey
in: cookie
name: og_session