# Webhook deliveries

## Endpoints

- `GET /platform/webhook-deliveries`: [List team webhook deliveries](https://docs.polymorfa.com/api/webhook-deliveries/list-team-webhook-deliveries)
- `GET /platform/webhook-deliveries/{deliveryId}/attempts`: [List team webhook delivery attempts](https://docs.polymorfa.com/api/webhook-deliveries/list-team-webhook-delivery-attempts)
- `GET /platform/projects/{projectId}/webhook-deliveries`: [List project webhook deliveries](https://docs.polymorfa.com/api/webhook-deliveries/list-project-webhook-deliveries)
- `GET /platform/projects/{projectId}/webhook-deliveries/{deliveryId}/attempts`: [List project webhook delivery attempts](https://docs.polymorfa.com/api/webhook-deliveries/list-project-webhook-delivery-attempts)
- `GET /platform/webhook-deliveries/{deliveryId}`: [Get team webhook delivery](https://docs.polymorfa.com/api/webhook-deliveries/get-team-webhook-delivery)
- `GET /platform/webhook-deliveries/{deliveryId}/attempts/{attemptId}`: [Get team webhook delivery attempt](https://docs.polymorfa.com/api/webhook-deliveries/get-team-webhook-delivery-attempt)
- `GET /platform/projects/{projectId}/webhook-deliveries/{deliveryId}`: [Get project webhook delivery](https://docs.polymorfa.com/api/webhook-deliveries/get-project-webhook-delivery)
- `GET /platform/projects/{projectId}/webhook-deliveries/{deliveryId}/attempts/{attemptId}`: [Get project webhook delivery attempt](https://docs.polymorfa.com/api/webhook-deliveries/get-project-webhook-delivery-attempt)
- `POST /platform/webhook-deliveries/{deliveryId}/retry`: [Retry team webhook delivery](https://docs.polymorfa.com/api/webhook-deliveries/retry-team-webhook-delivery)
- `POST /platform/projects/{projectId}/webhook-deliveries/{deliveryId}/retry`: [Retry project webhook delivery](https://docs.polymorfa.com/api/webhook-deliveries/retry-project-webhook-delivery)

## The team webhook delivery object

### Attributes

- `id` (string (uuid), required, format uuid). Identifier for this resource.
- `teamId` (string (uuid), required, format uuid). Identifier for the team.
- `projectId` (string, required, nullable). Identifier of the Polymorfa project that owns this resource.
- `eventId` (string (uuid), required, format uuid). Identifier for the event.
- `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
- `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
- `attemptCount` (integer, required, min 0). Number of attempts.
- `capabilities` (object, required). Structured capabilities values for this management team webhook delivery.
  - `retryable` (boolean, required). Whether retryable.
- `payloadAvailability` (string, required). Specifies payload availability for this management team webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
- `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management team webhook delivery.
- `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
- `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
- `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
- `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
- `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
- `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
- `lastOutcome` (object, required, nullable). Structured last outcome values for this management team webhook delivery.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
  - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.
```json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "teamId": "00000000-0000-4000-8000-000000000000",
  "projectId": null,
  "eventId": "00000000-0000-4000-8000-000000000000",
  "webhookId": "00000000-0000-4000-8000-000000000000",
  "status": "pending",
  "attemptCount": 0,
  "capabilities": {
    "retryable": true
  },
  "payloadAvailability": "available",
  "replayableUntil": "2026-09-22T12:00:00Z",
  "metadataExpiresAt": "2026-09-22T12:00:00Z",
  "nextAttemptAt": "2026-09-22T12:00:00Z",
  "lastAttemptAt": "2026-09-22T12:00:00Z",
  "completedAt": "2026-09-22T12:00:00Z",
  "createdAt": "2026-09-22T12:00:00Z",
  "updatedAt": "2026-09-22T12:00:00Z",
  "lastOutcome": {
    "statusCode": 100,
    "errorCode": "string"
  }
}
```

## The project webhook delivery object

### Attributes

- `id` (string (uuid), required, format uuid). Identifier for this resource.
- `teamId` (string (uuid), required, format uuid). Identifier for the team.
- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
- `eventId` (string (uuid), required, format uuid). Identifier for the event.
- `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
- `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
- `attemptCount` (integer, required, min 0). Number of attempts.
- `capabilities` (object, required). Structured capabilities values for this management project webhook delivery.
  - `retryable` (boolean, required). Whether retryable.
- `payloadAvailability` (string, required). Specifies payload availability for this management project webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
- `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management project webhook delivery.
- `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
- `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
- `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
- `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
- `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
- `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
- `lastOutcome` (object, required, nullable). Structured last outcome values for this management project webhook delivery.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
  - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.
```json
{
  "id": "00000000-0000-4000-8000-000000000000",
  "teamId": "00000000-0000-4000-8000-000000000000",
  "projectId": "00000000-0000-4000-8000-000000000000",
  "eventId": "00000000-0000-4000-8000-000000000000",
  "webhookId": "00000000-0000-4000-8000-000000000000",
  "status": "pending",
  "attemptCount": 0,
  "capabilities": {
    "retryable": true
  },
  "payloadAvailability": "available",
  "replayableUntil": "2026-09-22T12:00:00Z",
  "metadataExpiresAt": "2026-09-22T12:00:00Z",
  "nextAttemptAt": "2026-09-22T12:00:00Z",
  "lastAttemptAt": "2026-09-22T12:00:00Z",
  "completedAt": "2026-09-22T12:00:00Z",
  "createdAt": "2026-09-22T12:00:00Z",
  "updatedAt": "2026-09-22T12:00:00Z",
  "lastOutcome": {
    "statusCode": 100,
    "errorCode": "string"
  }
}
```

## List team webhook deliveries

`GET https://api.polymorfa.com/platform/webhook-deliveries` (Platform API)

Required permission: `webhook-deliveries:read`

Lists logical deliveries for team-owned webhooks. Project-owned deliveries are excluded.

Team keys require `webhook-deliveries:read`. Project tokens are not accepted.

### Query parameters

- `webhookId` (string (uuid), format uuid). Identifier for the webhook.
- `eventId` (string (uuid), format uuid). Identifier for the event.
- `status` (string). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
- `since` (string (date-time), format date-time). Specifies since for this query parameter.
- `until` (string (date-time), format date-time). Specifies until for this query parameter.
- `limit` (integer, range 1–100). Specifies limit for this query parameter. Default: `25`.
- `cursor` (string). Specifies cursor for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/webhook-deliveries" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (array of object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string, required, nullable). Identifier of the Polymorfa project that owns this resource.
  - `eventId` (string (uuid), required, format uuid). Identifier for the event.
  - `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
  - `attemptCount` (integer, required, min 0). Number of attempts.
  - `capabilities` (object, required). Structured capabilities values for this management team webhook delivery.
    - `retryable` (boolean, required). Whether retryable.
  - `payloadAvailability` (string, required). Specifies payload availability for this management team webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
  - `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management team webhook delivery.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
  - `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
  - `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
  - `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
  - `lastOutcome` (object, required, nullable). Structured last outcome values for this management team webhook delivery.
    - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
    - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.
- `page` (object, required). Specifies page for this schema.
  - `nextCursor` (string, required, nullable). Specifies next cursor for this management cursor page metadata.
  - `hasMore` (boolean, required). Whether more.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "teamId": "00000000-0000-4000-8000-000000000000",
      "projectId": null,
      "eventId": "00000000-0000-4000-8000-000000000000",
      "webhookId": "00000000-0000-4000-8000-000000000000",
      "status": "pending",
      "attemptCount": 0,
      "capabilities": {
        "retryable": true
      },
      "payloadAvailability": "available",
      "replayableUntil": "2026-09-22T12:00:00Z",
      "metadataExpiresAt": "2026-09-22T12:00:00Z",
      "nextAttemptAt": "2026-09-22T12:00:00Z",
      "lastAttemptAt": "2026-09-22T12:00:00Z",
      "completedAt": "2026-09-22T12:00:00Z",
      "createdAt": "2026-09-22T12:00:00Z",
      "updatedAt": "2026-09-22T12:00:00Z",
      "lastOutcome": {
        "statusCode": 100,
        "errorCode": "string"
      }
    }
  ],
  "page": {
    "nextCursor": "string",
    "hasMore": true
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

## List team webhook delivery attempts

`GET https://api.polymorfa.com/platform/webhook-deliveries/{deliveryId}/attempts` (Platform API)

Required permission: `webhook-deliveries:read`

Lists immutable network attempts for one team webhook delivery.

Team keys require `webhook-deliveries:read`. Project tokens are not accepted.

### Path parameters

- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Query parameters

- `limit` (integer, range 1–100). Specifies limit for this query parameter. Default: `25`.
- `cursor` (string). Specifies cursor for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/webhook-deliveries/<deliveryId>/attempts" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (array of object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string, required, nullable). Identifier of the Polymorfa project that owns this resource.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `number` (integer, required, min 1). Specifies number for this management team webhook delivery attempt.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `succeeded`, `failed`.
  - `startedAt` (string (date-time), required, nullable, format date-time). Timestamp for started at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `nextRetryAt` (string (date-time), required, nullable, format date-time). Timestamp for next retry at.
  - `durationMs` (integer, required, nullable, min 0). Specifies duration ms for this management team webhook delivery attempt.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this management team webhook delivery attempt.
  - `errorCode` (string, required, nullable). Machine-readable error code for this management team webhook delivery attempt.
  - `response` (object, required, nullable). A redacted excerpt from a failed HTTP response. Successful responses and network errors do not include a response body.
    - `contentType` (string, required, length 1–128, Media type: IANA `type/subtype` value matching the payload, such as `image/jpeg`, `video/mp4`, `audio/ogg`, or `application/pdf`). IANA media type that matches the payload.
    - `excerpt` (string, required, UTF-8 size: At most `8192` UTF-8 bytes). Redacted response text, limited to 8192 UTF-8 bytes.
    - `truncated` (boolean, required). Whether truncated.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
- `page` (object, required). Specifies page for this schema.
  - `nextCursor` (string, required, nullable). Specifies next cursor for this management cursor page metadata.
  - `hasMore` (boolean, required). Whether more.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "teamId": "00000000-0000-4000-8000-000000000000",
      "projectId": null,
      "deliveryId": "00000000-0000-4000-8000-000000000000",
      "number": 1,
      "status": "pending",
      "startedAt": "2026-09-22T12:00:00Z",
      "completedAt": "2026-09-22T12:00:00Z",
      "nextRetryAt": "2026-09-22T12:00:00Z",
      "durationMs": 0,
      "statusCode": 100,
      "errorCode": "string",
      "response": {
        "contentType": "string",
        "excerpt": "string",
        "truncated": true
      },
      "metadataExpiresAt": "2026-09-22T12:00:00Z"
    }
  ],
  "page": {
    "nextCursor": "string",
    "hasMore": true
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## List project webhook deliveries

`GET https://api.polymorfa.com/platform/projects/{projectId}/webhook-deliveries` (Platform API)

Required permission: `webhook-deliveries:read`

Lists logical webhook deliveries owned by the exact project in the route.

Requires `webhook-deliveries:read`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.

### Query parameters

- `webhookId` (string (uuid), format uuid). Identifier for the webhook.
- `eventId` (string (uuid), format uuid). Identifier for the event.
- `status` (string). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
- `since` (string (date-time), format date-time). Specifies since for this query parameter.
- `until` (string (date-time), format date-time). Specifies until for this query parameter.
- `limit` (integer, range 1–100). Specifies limit for this query parameter. Default: `25`.
- `cursor` (string). Specifies cursor for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/webhook-deliveries" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (array of object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
  - `eventId` (string (uuid), required, format uuid). Identifier for the event.
  - `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
  - `attemptCount` (integer, required, min 0). Number of attempts.
  - `capabilities` (object, required). Structured capabilities values for this management project webhook delivery.
    - `retryable` (boolean, required). Whether retryable.
  - `payloadAvailability` (string, required). Specifies payload availability for this management project webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
  - `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management project webhook delivery.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
  - `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
  - `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
  - `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
  - `lastOutcome` (object, required, nullable). Structured last outcome values for this management project webhook delivery.
    - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
    - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.
- `page` (object, required). Specifies page for this schema.
  - `nextCursor` (string, required, nullable). Specifies next cursor for this management cursor page metadata.
  - `hasMore` (boolean, required). Whether more.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "teamId": "00000000-0000-4000-8000-000000000000",
      "projectId": "00000000-0000-4000-8000-000000000000",
      "eventId": "00000000-0000-4000-8000-000000000000",
      "webhookId": "00000000-0000-4000-8000-000000000000",
      "status": "pending",
      "attemptCount": 0,
      "capabilities": {
        "retryable": true
      },
      "payloadAvailability": "available",
      "replayableUntil": "2026-09-22T12:00:00Z",
      "metadataExpiresAt": "2026-09-22T12:00:00Z",
      "nextAttemptAt": "2026-09-22T12:00:00Z",
      "lastAttemptAt": "2026-09-22T12:00:00Z",
      "completedAt": "2026-09-22T12:00:00Z",
      "createdAt": "2026-09-22T12:00:00Z",
      "updatedAt": "2026-09-22T12:00:00Z",
      "lastOutcome": {
        "statusCode": 100,
        "errorCode": "string"
      }
    }
  ],
  "page": {
    "nextCursor": "string",
    "hasMore": true
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## List project webhook delivery attempts

`GET https://api.polymorfa.com/platform/projects/{projectId}/webhook-deliveries/{deliveryId}/attempts` (Platform API)

Required permission: `webhook-deliveries:read`

Lists immutable network attempts for one project webhook delivery.

Requires `webhook-deliveries:read`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Query parameters

- `limit` (integer, range 1–100). Specifies limit for this query parameter. Default: `25`.
- `cursor` (string). Specifies cursor for this query parameter.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/webhook-deliveries/<deliveryId>/attempts" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (array of object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `number` (integer, required, min 1). Specifies number for this management project webhook delivery attempt.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `succeeded`, `failed`.
  - `startedAt` (string (date-time), required, nullable, format date-time). Timestamp for started at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `nextRetryAt` (string (date-time), required, nullable, format date-time). Timestamp for next retry at.
  - `durationMs` (integer, required, nullable, min 0). Specifies duration ms for this management project webhook delivery attempt.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this management project webhook delivery attempt.
  - `errorCode` (string, required, nullable). Machine-readable error code for this management project webhook delivery attempt.
  - `response` (object, required, nullable). A redacted excerpt from a failed HTTP response. Successful responses and network errors do not include a response body.
    - `contentType` (string, required, length 1–128, Media type: IANA `type/subtype` value matching the payload, such as `image/jpeg`, `video/mp4`, `audio/ogg`, or `application/pdf`). IANA media type that matches the payload.
    - `excerpt` (string, required, UTF-8 size: At most `8192` UTF-8 bytes). Redacted response text, limited to 8192 UTF-8 bytes.
    - `truncated` (boolean, required). Whether truncated.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
- `page` (object, required). Specifies page for this schema.
  - `nextCursor` (string, required, nullable). Specifies next cursor for this management cursor page metadata.
  - `hasMore` (boolean, required). Whether more.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "teamId": "00000000-0000-4000-8000-000000000000",
      "projectId": "00000000-0000-4000-8000-000000000000",
      "deliveryId": "00000000-0000-4000-8000-000000000000",
      "number": 1,
      "status": "pending",
      "startedAt": "2026-09-22T12:00:00Z",
      "completedAt": "2026-09-22T12:00:00Z",
      "nextRetryAt": "2026-09-22T12:00:00Z",
      "durationMs": 0,
      "statusCode": 100,
      "errorCode": "string",
      "response": {
        "contentType": "string",
        "excerpt": "string",
        "truncated": true
      },
      "metadataExpiresAt": "2026-09-22T12:00:00Z"
    }
  ],
  "page": {
    "nextCursor": "string",
    "hasMore": true
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Get team webhook delivery

`GET https://api.polymorfa.com/platform/webhook-deliveries/{deliveryId}` (Platform API)

Required permission: `webhook-deliveries:read`

Returns one logical team webhook delivery.

Team keys require `webhook-deliveries:read`. Project tokens are not accepted.

### Path parameters

- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Request

```bash
curl "https://api.polymorfa.com/platform/webhook-deliveries/<deliveryId>" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string, required, nullable). Identifier of the Polymorfa project that owns this resource.
  - `eventId` (string (uuid), required, format uuid). Identifier for the event.
  - `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
  - `attemptCount` (integer, required, min 0). Number of attempts.
  - `capabilities` (object, required). Structured capabilities values for this management team webhook delivery.
    - `retryable` (boolean, required). Whether retryable.
  - `payloadAvailability` (string, required). Specifies payload availability for this management team webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
  - `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management team webhook delivery.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
  - `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
  - `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
  - `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
  - `lastOutcome` (object, required, nullable). Structured last outcome values for this management team webhook delivery.
    - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
    - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "teamId": "00000000-0000-4000-8000-000000000000",
    "projectId": null,
    "eventId": "00000000-0000-4000-8000-000000000000",
    "webhookId": "00000000-0000-4000-8000-000000000000",
    "status": "pending",
    "attemptCount": 0,
    "capabilities": {
      "retryable": true
    },
    "payloadAvailability": "available",
    "replayableUntil": "2026-09-22T12:00:00Z",
    "metadataExpiresAt": "2026-09-22T12:00:00Z",
    "nextAttemptAt": "2026-09-22T12:00:00Z",
    "lastAttemptAt": "2026-09-22T12:00:00Z",
    "completedAt": "2026-09-22T12:00:00Z",
    "createdAt": "2026-09-22T12:00:00Z",
    "updatedAt": "2026-09-22T12:00:00Z",
    "lastOutcome": {
      "statusCode": 100,
      "errorCode": "string"
    }
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Get team webhook delivery attempt

`GET https://api.polymorfa.com/platform/webhook-deliveries/{deliveryId}/attempts/{attemptId}` (Platform API)

Required permission: `webhook-deliveries:read`

Returns one immutable network attempt.

Team keys require `webhook-deliveries:read`. Project tokens are not accepted.

### Path parameters

- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
- `attemptId` (string (uuid), required, format uuid). Identifier for the attempt.

### Request

```bash
curl "https://api.polymorfa.com/platform/webhook-deliveries/<deliveryId>/attempts/<attemptId>" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string, required, nullable). Identifier of the Polymorfa project that owns this resource.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `number` (integer, required, min 1). Specifies number for this management team webhook delivery attempt.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `succeeded`, `failed`.
  - `startedAt` (string (date-time), required, nullable, format date-time). Timestamp for started at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `nextRetryAt` (string (date-time), required, nullable, format date-time). Timestamp for next retry at.
  - `durationMs` (integer, required, nullable, min 0). Specifies duration ms for this management team webhook delivery attempt.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this management team webhook delivery attempt.
  - `errorCode` (string, required, nullable). Machine-readable error code for this management team webhook delivery attempt.
  - `response` (object, required, nullable). A redacted excerpt from a failed HTTP response. Successful responses and network errors do not include a response body.
    - `contentType` (string, required, length 1–128, Media type: IANA `type/subtype` value matching the payload, such as `image/jpeg`, `video/mp4`, `audio/ogg`, or `application/pdf`). IANA media type that matches the payload.
    - `excerpt` (string, required, UTF-8 size: At most `8192` UTF-8 bytes). Redacted response text, limited to 8192 UTF-8 bytes.
    - `truncated` (boolean, required). Whether truncated.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "teamId": "00000000-0000-4000-8000-000000000000",
    "projectId": null,
    "deliveryId": "00000000-0000-4000-8000-000000000000",
    "number": 1,
    "status": "pending",
    "startedAt": "2026-09-22T12:00:00Z",
    "completedAt": "2026-09-22T12:00:00Z",
    "nextRetryAt": "2026-09-22T12:00:00Z",
    "durationMs": 0,
    "statusCode": 100,
    "errorCode": "string",
    "response": {
      "contentType": "string",
      "excerpt": "string",
      "truncated": true
    },
    "metadataExpiresAt": "2026-09-22T12:00:00Z"
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Get project webhook delivery

`GET https://api.polymorfa.com/platform/projects/{projectId}/webhook-deliveries/{deliveryId}` (Platform API)

Required permission: `webhook-deliveries:read`

Returns one logical webhook delivery owned by the exact project.

Requires `webhook-deliveries:read`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/webhook-deliveries/<deliveryId>" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
  - `eventId` (string (uuid), required, format uuid). Identifier for the event.
  - `webhookId` (string (uuid), required, format uuid). Identifier for the webhook.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `retrying`, `succeeded`, `failed`.
  - `attemptCount` (integer, required, min 0). Number of attempts.
  - `capabilities` (object, required). Structured capabilities values for this management project webhook delivery.
    - `retryable` (boolean, required). Whether retryable.
  - `payloadAvailability` (string, required). Specifies payload availability for this management project webhook delivery. Values: `available`, `not_retained`, `expired`, `redacted`, `unavailable`.
  - `replayableUntil` (string (date-time), required, nullable, format date-time). Specifies replayable until for this management project webhook delivery.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.
  - `nextAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for next attempt at.
  - `lastAttemptAt` (string (date-time), required, nullable, format date-time). Timestamp for last attempt at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
  - `updatedAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was last updated.
  - `lastOutcome` (object, required, nullable). Structured last outcome values for this management project webhook delivery.
    - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this last outcome.
    - `errorCode` (string, required, nullable). Machine-readable error code for this last outcome.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "teamId": "00000000-0000-4000-8000-000000000000",
    "projectId": "00000000-0000-4000-8000-000000000000",
    "eventId": "00000000-0000-4000-8000-000000000000",
    "webhookId": "00000000-0000-4000-8000-000000000000",
    "status": "pending",
    "attemptCount": 0,
    "capabilities": {
      "retryable": true
    },
    "payloadAvailability": "available",
    "replayableUntil": "2026-09-22T12:00:00Z",
    "metadataExpiresAt": "2026-09-22T12:00:00Z",
    "nextAttemptAt": "2026-09-22T12:00:00Z",
    "lastAttemptAt": "2026-09-22T12:00:00Z",
    "completedAt": "2026-09-22T12:00:00Z",
    "createdAt": "2026-09-22T12:00:00Z",
    "updatedAt": "2026-09-22T12:00:00Z",
    "lastOutcome": {
      "statusCode": 100,
      "errorCode": "string"
    }
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Get project webhook delivery attempt

`GET https://api.polymorfa.com/platform/projects/{projectId}/webhook-deliveries/{deliveryId}/attempts/{attemptId}` (Platform API)

Required permission: `webhook-deliveries:read`

Returns one immutable network attempt owned by the exact project.

Requires `webhook-deliveries:read`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
- `attemptId` (string (uuid), required, format uuid). Identifier for the attempt.

### Request

```bash
curl "https://api.polymorfa.com/platform/projects/<projectId>/webhook-deliveries/<deliveryId>/attempts/<attemptId>" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `id` (string (uuid), required, format uuid). Identifier for this resource.
  - `teamId` (string (uuid), required, format uuid). Identifier for the team.
  - `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `number` (integer, required, min 1). Specifies number for this management project webhook delivery attempt.
  - `status` (string, required). Current status of this resource or operation. Values: `pending`, `delivering`, `succeeded`, `failed`.
  - `startedAt` (string (date-time), required, nullable, format date-time). Timestamp for started at.
  - `completedAt` (string (date-time), required, nullable, format date-time). ISO 8601 timestamp when this operation completed.
  - `nextRetryAt` (string (date-time), required, nullable, format date-time). Timestamp for next retry at.
  - `durationMs` (integer, required, nullable, min 0). Specifies duration ms for this management project webhook delivery attempt.
  - `statusCode` (integer, required, nullable, range 100–599). Machine-readable status code for this management project webhook delivery attempt.
  - `errorCode` (string, required, nullable). Machine-readable error code for this management project webhook delivery attempt.
  - `response` (object, required, nullable). A redacted excerpt from a failed HTTP response. Successful responses and network errors do not include a response body.
    - `contentType` (string, required, length 1–128, Media type: IANA `type/subtype` value matching the payload, such as `image/jpeg`, `video/mp4`, `audio/ogg`, or `application/pdf`). IANA media type that matches the payload.
    - `excerpt` (string, required, UTF-8 size: At most `8192` UTF-8 bytes). Redacted response text, limited to 8192 UTF-8 bytes.
    - `truncated` (boolean, required). Whether truncated.
  - `metadataExpiresAt` (string (date-time), required, format date-time). Timestamp for metadata expires at.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "teamId": "00000000-0000-4000-8000-000000000000",
    "projectId": "00000000-0000-4000-8000-000000000000",
    "deliveryId": "00000000-0000-4000-8000-000000000000",
    "number": 1,
    "status": "pending",
    "startedAt": "2026-09-22T12:00:00Z",
    "completedAt": "2026-09-22T12:00:00Z",
    "nextRetryAt": "2026-09-22T12:00:00Z",
    "durationMs": 0,
    "statusCode": 100,
    "errorCode": "string",
    "response": {
      "contentType": "string",
      "excerpt": "string",
      "truncated": true
    },
    "metadataExpiresAt": "2026-09-22T12:00:00Z"
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

## Retry team webhook delivery

`POST https://api.polymorfa.com/platform/webhook-deliveries/{deliveryId}/retry` (Platform API)

Required permission: `webhook-deliveries:retry`

Appends a new immutable attempt to the same logical delivery.

Team keys require `webhook-deliveries:retry`. Project tokens are not accepted.

### Path parameters

- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Header parameters

- `Idempotency-Key` (string, required, length 1–255). Specifies idempotency key for this header parameter.

### Request

```bash
curl -X POST "https://api.polymorfa.com/platform/webhook-deliveries/<deliveryId>/retry" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22" \
  -H "Idempotency-Key: <idempotency_key>"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `operationId` (string (uuid), required, format uuid). Identifier used to retrieve the asynchronous operation.
  - `idempotency` (object, required). Specifies idempotency for this management team webhook delivery retry receipt.
    - `id` (string (uuid), required, format uuid). Identifier for this resource.
    - `key` (string, required, length 1–255). Specifies key for this management idempotency receipt.
    - `replayed` (boolean, required). Whether replayed.
    - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
    - `expiresAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource expires.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `attemptId` (string (uuid), required, format uuid). Identifier for the attempt.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "operationId": "00000000-0000-4000-8000-000000000000",
    "idempotency": {
      "id": "00000000-0000-4000-8000-000000000000",
      "key": "string",
      "replayed": true,
      "createdAt": "2026-09-22T12:00:00Z",
      "expiresAt": "2026-09-22T12:00:00Z"
    },
    "deliveryId": "00000000-0000-4000-8000-000000000000",
    "attemptId": "00000000-0000-4000-8000-000000000000"
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 409

The request conflicts with the resource's current state.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "conflict_error",
    "code": "state_conflict",
    "message": "The request conflicts with the resource state.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#state-conflict"
}
```

#### 422

The retained payload is unavailable or no longer replayable.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

## Retry project webhook delivery

`POST https://api.polymorfa.com/platform/projects/{projectId}/webhook-deliveries/{deliveryId}/retry` (Platform API)

Required permission: `webhook-deliveries:retry`

Appends a new immutable attempt to the same logical delivery owned by the exact project.

Requires `webhook-deliveries:retry`. Project tokens only access resources in their own project.

### Path parameters

- `projectId` (string (uuid), required, format uuid). Identifier of the Polymorfa project that owns this resource.
- `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.

### Header parameters

- `Idempotency-Key` (string, required, length 1–255). Specifies idempotency key for this header parameter.

### Request

```bash
curl -X POST "https://api.polymorfa.com/platform/projects/<projectId>/webhook-deliveries/<deliveryId>/retry" \
  -H "Authorization: Bearer <POLYMORFA_API_KEY>" \
  -H "Polymorfa-Version: 2026-09-22" \
  -H "Idempotency-Key: <idempotency_key>"
```

### Responses

#### 200

Success
- `data` (object, required). Structured data carried by this object.
  - `operationId` (string (uuid), required, format uuid). Identifier used to retrieve the asynchronous operation.
  - `idempotency` (object, required). Specifies idempotency for this management project webhook delivery retry receipt.
    - `id` (string (uuid), required, format uuid). Identifier for this resource.
    - `key` (string, required, length 1–255). Specifies key for this management idempotency receipt.
    - `replayed` (boolean, required). Whether replayed.
    - `createdAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource was created.
    - `expiresAt` (string (date-time), required, format date-time). ISO 8601 timestamp when this resource expires.
  - `deliveryId` (string (uuid), required, format uuid). Identifier for the delivery.
  - `attemptId` (string (uuid), required, format uuid). Identifier for the attempt.

Headers:

- `X-Request-Id` (string). Stable request correlation identifier.
- `X-Trace-Id` (string, pattern ^[0-9a-f]{32}$). W3C trace ID of this request. Your `traceparent` trace ID when you sent a valid one.
- `Polymorfa-Version` (string). API version applied to this response.

```json
{
  "data": {
    "operationId": "00000000-0000-4000-8000-000000000000",
    "idempotency": {
      "id": "00000000-0000-4000-8000-000000000000",
      "key": "string",
      "replayed": true,
      "createdAt": "2026-09-22T12:00:00Z",
      "expiresAt": "2026-09-22T12:00:00Z"
    },
    "deliveryId": "00000000-0000-4000-8000-000000000000",
    "attemptId": "00000000-0000-4000-8000-000000000000"
  }
}
```

#### 400

A path, query, or request-body value did not pass validation.
- `error` (object, required). Error details returned when the operation fails.
  - `type` (string, required). Type discriminator for this object. Values: `invalid_request_error`, `authentication_error`, `permission_error`, `billing_error`, `conflict_error`, `rate_limit_error`, `api_error`, `upstream_error`.
  - `code` (string, required). Stable failure code. Use this value for programmatic handling.
  - `message` (string, required). Safe explanation of the failure.
  - `param` (string, required, nullable). Invalid request field, or null when no field applies.
  - `request_id` (string, required). Matches the X-Request-Id response header. Include it when you contact support.
  - `request_log_url` (string (uri), format uri). Console page that shows this request. Returned only to team and project credentials whose request was logged.
- `data` (string, required, nullable). Always null for a failed request.
- `docs` (string (uri), required, format uri). Documentation link to this failure code.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```

#### 401

Missing/invalid credential for this audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_credential",
    "message": "Supply a valid credential.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-credential"
}
```

#### 403

Authenticated but lacks the required scope/role/audience.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "permission_error",
    "code": "permission_denied",
    "message": "The credential does not have access to this resource.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#permission-denied"
}
```

#### 404

The requested resource was not found inside the authenticated team or project scope.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_not_found",
    "message": "The resource is unavailable to this caller.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#resource-not-found"
}
```

#### 409

The request conflicts with the resource's current state.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "conflict_error",
    "code": "state_conflict",
    "message": "The request conflicts with the resource state.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#state-conflict"
}
```

#### 422

The retained payload is unavailable or no longer replayable.
Same fields as 400.

Headers:

- `X-Request-Id`, `X-Trace-Id`, `Polymorfa-Version`: described under 200.

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Correct the invalid request field.",
    "param": null,
    "request_id": "5f0c2a8e-3b1d-4c6f-9e2a-7d4b1c8f6a30"
  },
  "data": null,
  "docs": "https://docs.polymorfa.com/api/errors#invalid-parameter"
}
```
