FinBaze for Platforms

Reference

Policy changes, quotas, usage reports, partner alerts and agent tasks. Samples show the envelope; data.object of an event that has a snapshot carries the object's fields as of the event (shown here with its type and id). See the envelope.

agent_task.completed#

An agent task completed.

Object: agent_task · module ai.agents: no event is published for a company where it is hidden or off.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b10",
  "object": "event",
  "type": "agent_task.completed",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1000",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "AgentTask",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

agent_task.failed#

An agent task failed.

Object: agent_task · module ai.agents: no event is published for a company where it is hidden or off.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b11",
  "object": "event",
  "type": "agent_task.failed",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1001",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "AgentTask",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

agent_task.waiting_approval#

An agent task waits for approval.

Object: agent_task · module ai.agents: no event is published for a company where it is hidden or off.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b12",
  "object": "event",
  "type": "agent_task.waiting_approval",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1002",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "AgentTask",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

agent_task.waiting_input#

An agent task waits for input.

Object: agent_task · module ai.agents: no event is published for a company where it is hidden or off.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b13",
  "object": "event",
  "type": "agent_task.waiting_input",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1003",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "AgentTask",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

billing.usage.reported#

The month's usage was closed and reported.

Object: platform_usage.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b14",
  "object": "event",
  "type": "billing.usage.reported",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1004",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "PlatformUsage",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

platform.alert#

Something needs the platform's attention: a failing or disabled webhook endpoint, a stalled feed, a rejected filing.

Object: platform_alert.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b15",
  "object": "event",
  "type": "platform.alert",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1005",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "Event",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34",
      "kind": "webhook_endpoint_failing",
      "severity": "info",
      "status": "open",
      "title": "example",
      "subject": {
        "type": "webhook_endpoint",
        "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
      },
      "companyId": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34",
      "detail": {},
      "raisedAt": "2026-03-02T10:00:00.000Z",
      "resolvedAt": "2026-03-02T10:00:00.000Z"
    }
  }
}

policy.activated#

A policy version was activated (also by a promotion).

Object: platform_policy.

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b16",
  "object": "event",
  "type": "policy.activated",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1006",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "PlatformPolicy",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}

quota.reached#

A company reached one of its quotas for the month.

Object: none (the event's own fields).

{
  "id": "evt_3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b17",
  "object": "event",
  "type": "quota.reached",
  "apiVersion": "2026-11-01",
  "created": "2026-03-02T10:00:00.000Z",
  "occurredAt": "2026-03-02T09:59:58.000Z",
  "sequence": "1007",
  "livemode": false,
  "platform": "00000000-0000-4000-8000-0000000000aa",
  "company": {
    "id": "00000000-0000-4000-8000-0000000000bb",
    "externalId": "biz-1001"
  },
  "request": null,
  "data": {
    "object": {
      "__typename": "Event",
      "id": "3f2b1c9e-5a47-4d1e-9c0b-2a6d8e7f1b34"
    }
  }
}