Skip to main content
POST
/
audit
/
v1
/
events
Submit audit event (service-to-service only)
curl --request POST \
  --url https://api.swarmd.ai/audit/v1/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "auditType": "COMMUNICATION_AUDIT",
  "sentAt": "2023-11-07T05:31:56Z",
  "correlationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "payload": {
    "version": 123,
    "method": "<string>",
    "stage": "<string>",
    "httpStatus": 123,
    "errorMessage": "<string>",
    "errorCode": "<string>",
    "requestBody": {},
    "requestHeaders": {},
    "responseBody": {},
    "responseHeaders": {},
    "taskState": "<string>"
  },
  "transport": "REST",
  "auditAction": "LOG",
  "durationMicros": 123,
  "sourceAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sourceUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sinkAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "metadata": {
    "version": 123,
    "source": "<string>"
  },
  "contextId": "<string>",
  "taskId": "<string>",
  "messageId": "<string>",
  "taskState": "<string>"
}
'
{
  "eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "receivedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

JWT token (USER, AGENT, or SERVICE auth)

Body

application/json
​
eventId
string<uuid>
required
​
tenantId
string<uuid>
required
​
auditType
enum<string>
required
Available options:
COMMUNICATION_AUDIT,
VALIDATION_RESULT,
X402_PAYMENT_REQUIRED,
X402_PAYMENT_SUCCESS,
X402_PAYMENT_ATTEMPT,
X402_PAYMENT_REJECTED,
REGEX_DETECTION,
PRESIDIO_DETECTION,
COMPREHEND_DETECTION,
RATE_LIMIT,
SKILL_RESTRICTION,
HITL,
HITL_GUARD,
HITL_RESOLUTION,
POLICY_LIFECYCLE
​
sentAt
string<date-time>
required
​
correlationId
string<uuid>
required
​
payload
object
required
​
transport
enum<string>
Available options:
REST,
JSONRPC,
GRPC
​
auditAction
enum<string>
Available options:
LOG,
MASK,
BLOCK,
WARN,
ERROR
​
durationMicros
integer<int64>
​
sourceAgentId
string<uuid>
​
sourceUserId
string<uuid>
​
sinkAgentId
string<uuid>
​
metadata
object
​
contextId
string
​
taskId
string
​
messageId
string
​
taskState
string

Response

201 - */*

Created

​
eventId
string<uuid>
required
​
status
string
required
​
receivedAt
string<date-time>
required