FOfountain
copilotAuditLogs

partially update many existing copilotAuditLog

Partially update many existing copilotAuditLog

patch/api/serviceorganizations/copilotAuditLogs

Request

  • Base URL
    https://services.fountain.com
  • URL
    https://services.fountain.com/api/serviceorganizations/copilotAuditLogs
  • Auth
    HTTP bearer

Request body

uuidstring uuid
createdAtstring date-time
createdBystring uuid
lastUpdatedAtstring date-time
lastUpdatedBystring uuid
lastUpdatedByAudiencestring
lastUpdatedByAudienceUuidstring uuid
lastUpdatedByImpersonatedBystring uuid
lastUpdatedByCompanyUuidstring uuid
lastUpdatedByEnterpriseUuidstring uuid
companyUuidstring uuid required

Unique identifier for the company

agentNamestring required

Name of the agent

exAgentIdinteger nullable

Internal ExAgent ID of the agent that ran the call. Null for a custom agent's own calls

exAgentThreadIdinteger

Internal ExAgent Thread ID

exAgentUuidstring uuid nullable

External ExAgent UUID of the agent that ran the call. Null for a custom agent's own calls

customAgentIdinteger nullable

Internal ID of the custom agent that made the call, or that spawned the worker that made it

customAgentUuidstring uuid nullable

UUID of the custom agent in customAgentId

subAgentIdinteger nullable

Internal ID of the worker (sub-agent) that made the call

subAgentUuidstring uuid nullable

UUID of the worker in subAgentId

exAgentThreadUuidstring uuid

External ExAgent Thread UUID

userIdstring

User ID who triggered the tool call

userEmailstring

User email who triggered the tool call

actionTypestring

Action type (if applicable)

outputstring

Serialized output of the tool call

statusstring

Status of the tool call

source'platform' | 'mcp_connector' | 'server_tool'

Where the tool call ran: the Fountain platform, an MCP connector, or an Anthropic-hosted server tool (web fetch, web search, code execution, tool search, advisor)

providerstring nullable

Provider key for non-platform sources: the connector key when source is mcp_connector, or "anthropic" when source is server_tool

annotationsobject

Any extra metadata annotations

Example request

[
  {
    "uuid": "f4428d27-c089-40c4-aa83-ce02e1ee1426",
    "createdAt": "2021-05-05T01:02:03.924Z",
    "createdBy": "1e4e9128-fbb2-4b0a-97fc-f65bb1efee55",
    "lastUpdatedAt": "2021-05-05T04:05:06.924Z",
    "lastUpdatedBy": "7097bb82-61bd-4724-82ac-eab598190e47",
    "lastUpdatedByAudience": "employer",
    "lastUpdatedByAudienceUuid": "68df4316-590a-4081-9f24-9d9311977c9d",
    "lastUpdatedByImpersonatedBy": "3462e1d4-0e27-4798-b4a2-76412ab21892",
    "lastUpdatedByCompanyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
    "lastUpdatedByEnterpriseUuid": "a6420cdc-285a-4f75-8ccc-8edff6d60c0a",
    "companyUuid": "06b0ee4f-3477-4091-a395-5e82b7c50cc7",
    "agentName": "Copilot Attendance Bot",
    "exAgentId": 123,
    "exAgentThreadId": 456,
    "exAgentUuid": "aabbccdd-eeff-1122-3344-556677889900",
    "customAgentId": 7,
    "customAgentUuid": "11223344-5566-7788-99aa-bbccddeeff00",
    "subAgentId": 12,
    "subAgentUuid": "99887766-5544-3322-1100-ffeeddccbbaa",
    "exAgentThreadUuid": "ddeeff00-1122-3344-5566-778899aabbcc",
    "userId": "user-123",
    "userEmail": "john.doe@company.com",
    "actionType": "TOOL_CALL",
    "output": "{\"result\": \"Success\", \"data\": {}}",
    "status": "success",
    "source": "platform",
    "provider": "microsoft_365"
  }
]

Response

copilotAuditLogs updated. Wrapped in a JsonAPI root response.

Example response

{
  "data": [
    {
      "uuid": "f4428d27-c089-40c4-aa83-ce02e1ee1426",
      "createdAt": "2021-05-05T01:02:03.924Z",
      "createdBy": "1e4e9128-fbb2-4b0a-97fc-f65bb1efee55",
      "lastUpdatedAt": "2021-05-05T04:05:06.924Z",
      "lastUpdatedBy": "7097bb82-61bd-4724-82ac-eab598190e47",
      "lastUpdatedByAudience": "employer",
      "lastUpdatedByAudienceUuid": "68df4316-590a-4081-9f24-9d9311977c9d",
      "lastUpdatedByImpersonatedBy": "3462e1d4-0e27-4798-b4a2-76412ab21892",
      "lastUpdatedByCompanyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
      "lastUpdatedByEnterpriseUuid": "a6420cdc-285a-4f75-8ccc-8edff6d60c0a",
      "companyUuid": "06b0ee4f-3477-4091-a395-5e82b7c50cc7",
      "agentName": "Copilot Attendance Bot",
      "exAgentId": 123,
      "exAgentThreadId": 456,
      "exAgentUuid": "aabbccdd-eeff-1122-3344-556677889900",
      "customAgentId": 7,
      "customAgentUuid": "11223344-5566-7788-99aa-bbccddeeff00",
      "subAgentId": 12,
      "subAgentUuid": "99887766-5544-3322-1100-ffeeddccbbaa",
      "exAgentThreadUuid": "ddeeff00-1122-3344-5566-778899aabbcc",
      "userId": "user-123",
      "userEmail": "john.doe@company.com",
      "actionType": "TOOL_CALL",
      "output": "{\"result\": \"Success\", \"data\": {}}",
      "status": "success",
      "source": "platform",
      "provider": "microsoft_365"
    }
  ],
  "meta": {
    "timestamp": "2021-05-05T09:47:58.924Z",
    "verb": "GET",
    "path": "/api/structure/resources/5949cf7c-fec6-4b31-947c-3aceabff58c5",
    "jti": "%cQN3RIGp",
    "rid": "$2d2zkHZ5",
    "count": 1,
    "status": "200",
    "duration": 17,
    "size": 1234
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.