ARartil
Webhooks

Add a webhook

Post an agent's events to a URL, signed as Standard Webhooks describes. Adding the same URL again returns its webhook with the same secret.

post/agents/{id}/webhooks

Request

  • Base URL
    https://app.artil.ai/api
  • URL
    https://app.artil.ai/api/agents/{id}/webhooks
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://mcp.artil.ai/oauth/authorize
      Token URL: https://mcp.artil.ai/oauth/token scopes: agent

Path parameters

idstring uuid required

The agent's id

Request body

urlstring uri required

Response

The webhook and its secret

idstring uuid required
urlstring uri required

Where Artil posts the agent's events

deliveredAtstring date-time nullable required
errorstring nullable required

Why the last delivery failed

erroredAtstring date-time nullable required
attemptsinteger required

How many times the event Artil is retrying has failed

retryAtstring date-time nullable required

When Artil next retries a failed event

createdAtstring date-time required
secretstring required

The Standard Webhooks key each delivery is signed with

Changes

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