Impri Actions API
The Actions API from Impri — 4 operation(s) for actions.
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/impri-dev:impri-dev-actions-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. 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: Impri Actions API
version: v1
description: Human-in-the-loop approval API for AI agents. POST an action, get a decision back via webhook or polling. The imprimatur for your AI agents.
servers:
- url: https://api.impri.dev/v1
description: API v1
security:
- bearerAuth: []
tags:
- name: Actions
paths:
/actions:
post:
operationId: createAction
summary: Submit an action for human approval
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateActionBody'
responses:
'200':
description: Idempotent match or soft duplicate
'201':
description: Action created
'400':
description: Validation error
'429':
description: Rate limit exceeded
tags:
- Actions
get:
operationId: listActions
summary: List actions with optional filters
parameters:
- name: status
in: query
schema:
$ref: '#/components/schemas/ActionStatus'
- name: since
in: query
schema:
type: integer
- name: kind
in: query
schema:
type: string
- name: limit
in: query
schema:
type: integer
default: 50
- name: cursor
in: query
schema:
type: string
responses:
'200':
description: Paginated list of actions
tags:
- Actions
/actions/{id}:
get:
operationId: getAction
summary: Get a single action by ID
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Action with decision and webhook delivery status
'404':
description: Not found
tags:
- Actions
/actions/{id}/decision:
post:
operationId: submitDecision
summary: Approve or reject an action
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionBody'
responses:
'200':
description: Decision recorded
'409':
description: Already decided
tags:
- Actions
/actions/{id}/result:
post:
operationId: reportResult
summary: Report execution result after approval
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ResultBody'
responses:
'200':
description: Result recorded
'409':
description: Action not in approved state
tags:
- Actions
components:
schemas:
DecisionBody:
$ref: '#/components/schemas/DecisionBody'
definitions:
DecisionBody:
type: object
properties:
decision:
type: string
enum:
- approve
- reject
edited:
type: object
additionalProperties: {}
channel:
type: string
pattern: ^[A-Za-z0-9_-]{0,64}$
required:
- decision
additionalProperties: false
$schema: http://json-schema.org/draft-07/schema#
ResultBody:
$ref: '#/components/schemas/ResultBody'
definitions:
ResultBody:
type: object
properties:
status:
type: string
enum:
- executed
- execute_failed
detail:
type: string
payload:
type: object
additionalProperties: {}
required:
- status
additionalProperties: false
$schema: http://json-schema.org/draft-07/schema#
CreateActionBody:
$ref: '#/components/schemas/CreateActionBody'
definitions:
CreateActionBody:
type: object
properties:
kind:
type: string
minLength: 1
maxLength: 100
title:
type: string
minLength: 1
maxLength: 500
pattern: ^[^\r\n]+$
preview:
type: object
properties:
format:
type: string
enum:
- markdown
- plain
- diff
default: plain
body:
type: string
maxLength: 262144
required:
- body
additionalProperties: false
payload: {}
target_url:
type: string
format: uri
callback_url:
type: string
format: uri
expires_in:
type: integer
minimum: 300
maximum: 2592000
default: 259200
idempotency_key:
type: string
maxLength: 255
editable:
type: array
items:
type: string
default: []
idempotent:
type: boolean
undo:
type: string
maxLength: 2000
required:
- kind
- title
- preview
additionalProperties: false
$schema: http://json-schema.org/draft-07/schema#
ActionStatus:
$ref: '#/components/schemas/ActionStatus'
definitions:
ActionStatus:
type: string
enum:
- pending
- approved
- rejected
- expired
- executed
- execute_failed
$schema: http://json-schema.org/draft-07/schema#
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: im_<key>