Python SDK for AI agent monitoring, LLM cost tracking, benchmarking, and more. Integrates with most LLMs and agent frameworks including CrewAI, Agno, OpenAI Agents SDK, Langchain, Autogen, AG2, and CamelAI
Python agentagentopsagents-sdkaianthropicautogencost-estimationcrewaievalsevaluation-metricsgroqlangchainllmmistralollamaopenaiopenai-agents
openapi: 3.0.3
info:
title: AgentOps API
description: API for managing sessions, agents, threads, and events.
version: 2.0.0
servers:
- url: https://api.agentops.ai
description: Production server
paths:
/reauthorize_jwt:
post:
summary: Reauthorize a JWT token
operationId: reauthorizeJWT
security:
- ApiKeyAuth: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
status:
type: string
jwt:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/create_session:
post:
summary: Create a new session
operationId: createSession
security:
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
init_timestamp:
type: string
format: date-time
end_timestamp:
type: string
format: date-time
end_state:
type: string
nullable: true
end_state_reason:
type: string
nullable: true
tags:
type: array
items:
type: string
nullable: true
host_env:
type: object
nullable: true
required:
- session_id
responses:
'200':
description: Session created successfully
content:
application/json:
schema:
type: object
properties:
status:
type: string
jwt:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/update_session:
post:
summary: Update an existing session
operationId: updateSession
security:
- BearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
init_timestamp:
type: string
format: date-time
nullable: true
end_timestamp:
type: string
format: date-time
nullable: true
end_state:
type: string
nullable: true
end_state_reason:
type: string
nullable: true
tags:
type: array
items:
type: string
nullable: true
host_env:
type: object
nullable: true
required:
- session_id
responses:
'200':
description: Session updated successfully
content:
application/json:
schema:
type: object
properties:
status:
type: string
token_cost:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/create_agent:
post:
summary: Create a new agent
operationId: createAgent
security:
- BearerAuth: []
responses:
'200':
description: Agent created successfully
content:
application/json:
schema:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/create_thread:
post:
summary: Create a new thread for an existing session
operationId: createThread
security:
- BearerAuth: []
responses:
'200':
description: Thread created successfully
content:
application/json:
schema:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/create_events:
post:
summary: Create multiple event types in a session
operationId: createEvents
security:
- BearerAuth: []
responses:
'200':
description: Events created successfully
content:
application/json:
schema:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/update_events:
post:
summary: Update multiple events in a session
operationId: updateEvents
security:
- BearerAuth: []
responses:
'200':
description: Events updated successfully
content:
application/json:
schema:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: string
/developer_errors:
post:
summary: Post a developer error
operationId: postDeveloperError
security:
- ApiKeyAuth: []
responses:
'200':
description: Developer error posted successfully
content:
application/json:
schema:
type: string
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: string
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-Agentops-Api-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT