Collate Agent Executions API
`Agent Executions` are time-series records of AI agent execution runs, capturing observability metrics, governance checks, and performance data.
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/collate:collate-agent-executions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: OpenMetadata Agent Executions API
description: Common types and API definition for OpenMetadata
contact:
name: OpenMetadata
url: https://open-metadata.org
email: openmetadata-dev@googlegroups.com
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
version: 2.0.5
servers:
- url: /api
description: Current Host
- url: http://localhost:8585/api
description: Endpoint URL
security:
- BearerAuth: []
tags:
- name: Agent Executions
description: '`Agent Executions` are time-series records of AI agent execution runs, capturing observability metrics, governance checks, and performance data.'
paths:
/v1/agentExecutions:
get:
tags:
- Agent Executions
summary: List agent executions
description: Get a list of agent executions, optionally filtered by agentId, startTs and endTs.
operationId: listAgentExecutions
parameters:
- name: agentId
in: query
description: Filter by agent ID
schema:
type: string
format: uuid
- name: startTs
in: query
description: Filter executions after the given start timestamp
schema:
type: number
- name: endTs
in: query
description: Filter executions before the given end timestamp
schema:
type: number
- name: limit
in: query
description: Limit the number of executions returned
schema:
type: integer
format: int32
responses:
'200':
description: List of agent executions
content:
application/json:
schema:
$ref: '#/components/schemas/AgentExecutionList'
post:
tags:
- Agent Executions
summary: Create an agent execution
description: Create a new agent execution record.
operationId: createAgentExecution
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AgentExecution'
responses:
'200':
description: Agent Execution
content:
application/json:
schema:
$ref: '#/components/schemas/AgentExecution'
'400':
description: Bad request
/v1/agentExecutions/{id}:
get:
tags:
- Agent Executions
summary: Get an agent execution by Id
description: Get an agent execution by `Id`.
operationId: getAgentExecutionByID
parameters:
- name: id
in: path
description: Id of the Agent Execution
required: true
schema:
type: string
format: uuid
responses:
'200':
description: The execution
content:
application/json:
schema:
$ref: '#/components/schemas/AgentExecution'
'404':
description: Execution for instance {id} is not found
delete:
tags:
- Agent Executions
summary: Delete an agent execution by Id
description: Delete an agent execution by `Id`.
operationId: deleteAgentExecution
parameters:
- name: id
in: path
description: Id of the Agent Execution
required: true
schema:
type: string
format: uuid
- name: hardDelete
in: query
description: Hard delete the entity. (Default = `false`)
schema:
type: boolean
responses:
'200':
description: OK
'404':
description: execution for instance {id} is not found
/v1/agentExecutions/{agentId}/{timestamp}:
delete:
tags:
- Agent Executions
summary: Delete agent execution data at a timestamp
description: Delete agent execution data for an agent at a specific timestamp.
operationId: deleteAgentExecutionData
parameters:
- name: agentId
in: path
description: ID of the AI Agent
required: true
schema:
type: string
format: uuid
- name: timestamp
in: path
description: Timestamp of the execution to delete
required: true
schema:
type: integer
format: int64
responses:
'200':
description: Successfully deleted Agent Execution Data
components:
schemas:
EntityReference:
required:
- id
- type
type: object
properties:
id:
type: string
format: uuid
type:
type: string
name:
type: string
fullyQualifiedName:
type: string
description:
type: string
displayName:
type: string
deleted:
type: boolean
inherited:
type: boolean
href:
type: string
format: uri
ComplianceCheck:
type: object
properties:
checkName:
type: string
passed:
type: boolean
details:
type: string
severity:
type: string
enum:
- Low
- Medium
- High
- Critical
AgentExecution:
required:
- agent
- agentId
- status
- timestamp
type: object
properties:
id:
type: string
format: uuid
agent:
$ref: '#/components/schemas/EntityReference'
agentId:
type: string
format: uuid
timestamp:
type: integer
format: int64
endTimestamp:
type: integer
format: int64
status:
type: string
enum:
- Running
- Success
- Failed
- Timeout
- Cancelled
- PartialSuccess
input:
type: string
output:
type: string
modelCalls:
type: array
items:
$ref: '#/components/schemas/ModelCall'
dataAccessed:
type: array
items:
$ref: '#/components/schemas/DataAccess'
toolCalls:
type: array
items:
$ref: '#/components/schemas/ToolCall'
metrics:
$ref: '#/components/schemas/ExecutionMetrics'
errorMessage:
type: string
errorStack:
type: string
complianceChecks:
type: array
items:
$ref: '#/components/schemas/ComplianceCheck'
executedBy:
type: string
sessionId:
type: string
environment:
type: string
enum:
- Development
- Staging
- Production
agentVersion:
type: string
metadata:
$ref: '#/components/schemas/Metadata'
deleted:
type: boolean
Metadata:
type: object
EntityError:
type: object
properties:
message:
type: string
entity:
type: object
Paging:
required:
- total
type: object
properties:
before:
type: string
after:
type: string
offset:
type: integer
format: int32
limit:
type: integer
format: int32
total:
type: integer
format: int32
DataAccess:
required:
- accessType
- dataSource
type: object
properties:
dataSource:
$ref: '#/components/schemas/EntityReference'
accessType:
type: string
enum:
- Read
- Write
- Update
- Delete
columns:
type: array
items:
type: string
recordCount:
type: integer
format: int32
query:
type: string
timestamp:
type: integer
format: int64
piiAccessed:
type: boolean
sensitivityLevel:
type: string
enum:
- Public
- Internal
- Confidential
- Restricted
AgentExecutionList:
required:
- data
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/AgentExecution'
paging:
$ref: '#/components/schemas/Paging'
errors:
type: array
items:
$ref: '#/components/schemas/EntityError'
warningsCount:
type: integer
format: int32
warnings:
type: array
items:
$ref: '#/components/schemas/EntityError'
Parameters__1:
type: object
ModelCall:
type: object
properties:
model:
$ref: '#/components/schemas/EntityReference'
prompt:
type: string
response:
type: string
inputTokens:
type: integer
format: int32
outputTokens:
type: integer
format: int32
latencyMs:
type: number
format: double
cost:
type: number
format: double
timestamp:
type: integer
format: int64
purpose:
type: string
ToolCall:
type: object
properties:
tool:
$ref: '#/components/schemas/EntityReference'
parameters:
$ref: '#/components/schemas/Parameters__1'
result:
type: string
success:
type: boolean
latencyMs:
type: number
format: double
timestamp:
type: integer
format: int64
errorMessage:
type: string
ExecutionMetrics:
type: object
properties:
totalRowsProcessed:
type: integer
format: int32
totalBytesProcessed:
type: integer
format: int32
cpuTime:
type: number
format: double
memoryUsed:
type: integer
format: int32
cost:
type: number
format: double
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
x-provenance:
method: harvested
publisher: Collate
source: https://sandbox.open-metadata.org/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)