Webhooks

Create webhook

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

post/v1/commands/create_webhook

Request

  • Base URL: https://app.agentlinkops.com
  • URL: https://app.agentlinkops.com/v1/commands/create_webhook
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

X-Workspace-IDstring

Required when using a Clerk human session. With an API key, omit this header or supply its bound workspace.

Request body

projectIdstring

project ID from create/list.

urlstring required

Public HTTPS endpoint or destination URL required by this operation.

descriptionstring

Optional human-readable description of this resource.

eventTypesstring[]

Event type filters for this subscription; omitted means all supported types.

feedsstring[]

Independent source or destination event feeds to subscribe to.

deliveryMode'events' | 'digest'

Choose individual event deliveries or one digest per configured window.

digestFrequency'daily' | 'weekly'

Digest window frequency; applicable only when deliveryMode is digest.

digestHourUtcinteger

UTC hour from 0 to 23 when the digest window closes.

Response

Command result, including queued admission.

idstring required

Resource identifier returned by the operation.

workspace_idstring required

Workspace that owns this record.

project_idstring nullable required

Project that owns this record.

urlstring required
descriptionstring required
statestring required

Saved lifecycle or evidence state, as enumerated for this record.

active_secret_countnumber required
event_typesstring[] nullable required
feedsstring[] required
delivery_modestring required
digest_frequencystring nullable required
digest_hour_utcnumber nullable required
digest_last_sent_atstring nullable required
consecutive_failuresnumber required
disabled_atstring nullable required
disabled_reasonstring nullable required
created_atstring required

UTC timestamp when the record was created.

updated_atstring required

UTC timestamp of the last record update.

secretstring

Webhook signing secret returned only when created or rotated. Store it securely.

Changes

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