Skip to main content
GET
/
api
/
v1
/
agents
/
{agentId}
/
tasks
/
{taskId}
/
webhooks
/
{webhookId}
/
deliveries
List webhook delivery attempts (audit log).
curl --request GET \
  --url https://openapi.beeos.ai/api/v1/agents/{agentId}/tasks/{taskId}/webhooks/{webhookId}/deliveries \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "deliveries": [
      {
        "delivery_id": "<string>",
        "webhook_id": "<string>",
        "task_id": "<string>",
        "attempt_num": 1,
        "last_response_status": 1,
        "next_attempt_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "last_error": "<string>",
        "last_attempted_at": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Pass a user JWT or a oag_ User API Key on the Authorization: Bearer <token> header. Both are validated by openapi-gateway against the Auth service.

Both credential types are user-scoped: every key (and every JWT) is bound to exactly one owner, and every route grants the caller full access to that owner's own resources. Cross-tenant access is denied by owner-ACL inside the handlers — there is no per-route scope vocabulary on this API.

Removed in v1.1.0: the legacy agents:* / tasks:* / files:* / instances:* scope set has been dropped together with the 403 insufficient_scope error. Existing oag_ keys automatically gain full owner-level access and do not need to be re-issued. SDK calls that previously passed scopes to createAPIKey should drop the argument. See the changelog at the bottom of this spec for the full migration note.

Path Parameters

​
agentId
string
required
Maximum string length: 128
​
taskId
string
required
Maximum string length: 128
​
webhookId
string
required
Maximum string length: 128

Query Parameters

​
limit
integer
default:50

Maximum number of delivery rows to return. Clamped to [1, 200]; default 50.

Required range: 1 <= x <= 200

Response

List of recent delivery attempts.

​
success
boolean
required
​
data
object
required