agentboxd-com Trust API
The emergency stop and human on call.
The emergency stop and human on call.
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/agentboxd-com:agentboxd-com-trust-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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:
title: Agentboxd Com Trust API
version: '1'
contact:
name: Agentboxd
url: https://agentboxd.com
email: hello@agentboxd.com
description: 'Operations tagged Trust across 2 of this provider''s published API definitions: agentboxd-com-openapi.json, agentboxd-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.agentboxd.com
security:
- apiKey: []
tags:
- name: Trust
description: The emergency stop and human on call.
paths:
/v1/emergency-stop:
post:
operationId: postEmergencyStop
tags:
- Trust
summary: Stop every agent in the workspace
description: '`{ reason? }` (up to 500 characters) stops every agent in the workspace: every send, reply, draft send and SMTP submission answers `423 workspace_stopped`, identity tokens are refused, scheduled drafts wait and the claim queue returns nothing. Reads, inbound mail and webhooks keep working. Needs `workspace:emergency` and an org-wide key. Emits `workspace.stopped`; returns `{ org }`. There is no API resume: an owner resumes in the dashboard. See Emergency stop.
Permission: `workspace:emergency`.'
x-permission: workspace:emergency
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
reason:
type: string
maxLength: 500
additionalProperties: false
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.agentboxd.com
/v1/escalation:
get:
operationId: getEscalation
tags:
- Trust
summary: Get the human-on-call settings
description: '`{ contacts: [{ email, status: "pending" | "confirmed", confirmed_at }], triggers, delivery, max_per_hour, quiet_hours, include_excerpt }`. Needs `escalation:manage` and an org-wide key. See Human on call.
Permission: `escalation:manage`.'
x-permission: escalation:manage
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
operationId: putEscalation
tags:
- Trust
summary: Update the human-on-call settings
description: 'Same fields; the ones you leave out keep their value. `contacts` (up to 5) replaces the list: new addresses get a confirmation email and receive nothing until confirmed. `triggers`: `needs_human`, `phishing`, `blocked`, `draft_failed`, `draft_created`, `emergency_stop`, `held` (booleans). `delivery`: `immediate` or `digest`. `max_per_hour`: 1–60. `quiet_hours`: `{ start: "22:00", end: "07:00", timezone: "Europe/Paris" }` or `null`. `include_excerpt`: add the first 500 characters of the text. At most 20 confirmation emails a day (`429 rate_limited`).
Permission: `escalation:manage`.'
x-permission: escalation:manage
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
contacts:
maxItems: 5
type: array
items:
type: string
maxLength: 254
format: email
pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
triggers:
type: object
properties:
needs_human:
type: boolean
phishing:
type: boolean
blocked:
type: boolean
draft_failed:
type: boolean
emergency_stop:
type: boolean
held:
type: boolean
draft_created:
type: boolean
additionalProperties: false
delivery:
type: string
enum:
- immediate
- digest
max_per_hour:
type: integer
minimum: 1
maximum: 60
quiet_hours:
anyOf:
- type: object
properties:
start:
type: string
pattern: ^([01]\d|2[0-3]):[0-5]\d$
end:
type: string
pattern: ^([01]\d|2[0-3]):[0-5]\d$
timezone:
type: string
minLength: 1
maxLength: 64
required:
- start
- end
- timezone
additionalProperties: false
- type: 'null'
include_excerpt:
type: boolean
additionalProperties: false
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.agentboxd.com
/v1/inboxes/{id}/escalation:
get:
operationId: getInboxesByIdEscalation
tags:
- Trust
summary: Get an inbox’s on-call settings
description: '`{ override, contacts, triggers }`: the inbox’s own on-call people and triggers (`triggers: null` = the workspace’s). Needs `escalation:manage`; an inbox-scoped key may manage its own inbox.
Permission: `escalation:manage`.'
x-permission: escalation:manage
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
operationId: putInboxesByIdEscalation
tags:
- Trust
summary: Update an inbox’s on-call settings
description: '`{ override?, contacts?, triggers? }`. With `override: true`, alerts about this inbox go to its own confirmed contacts instead of the workspace’s.
Permission: `escalation:manage`.'
x-permission: escalation:manage
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
override:
type: boolean
contacts:
maxItems: 5
type: array
items:
type: string
maxLength: 254
format: email
pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
triggers:
anyOf:
- type: object
properties:
needs_human:
type: boolean
phishing:
type: boolean
blocked:
type: boolean
draft_failed:
type: boolean
emergency_stop:
type: boolean
held:
type: boolean
draft_created:
type: boolean
additionalProperties: false
- type: 'null'
additionalProperties: false
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://api.agentboxd.com
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Stable, machine-readable error code.
message:
type: string
description: What happened and how to fix it, in plain words.
details:
description: 'The specifics: which recipient, which limit, until when.'
docs_url:
type: string
format: uri
description: 'For a refused send: its entry on "Why was my send refused?" (https://agentboxd.com/docs/send-refusals).'
securitySchemes:
apiKey:
type: http
scheme: bearer
description: An API key (`mr_…`), scoped to the workspace or one inbox, with a set of permissions.
externalDocs:
description: API reference
url: https://agentboxd.com/docs/api
x-refined-from:
- agentboxd-com-openapi.json
- agentboxd-com-openapi.json