Skip to content
Askara API
/
Webhook
/
Patch a webhook.

Askara API (1.0.0)

Askara.ai open API

Languages
Servers
Production

https://api.askara.ai/

Contact

Operations

Document

Operations

Organization

Operations

Patient

Operations

User

Operations

Webhook

Operations

Retrieve collection of webhooks.

Request

Use this endpoint to retrieve the collection of webhook information.

Query
pageinteger

The collection page number

Default 1
itemsPerPageinteger[ 0 .. 100 ]

The number of items per page

Default 20
order[id]string
Default "asc"
Enum"asc""desc"
order[uuid]string
Default "asc"
Enum"asc""desc"
order[url]string
Default "asc"
Enum"asc""desc"
order[secret]string
Default "asc"
Enum"asc""desc"
order[certificateVerificationDisabled]string
Default "asc"
Enum"asc""desc"
order[enabled]string
Default "asc"
Enum"asc""desc"
order[subscriptions]string
Default "asc"
Enum"asc""desc"
order[createdAt]string
Default "asc"
Enum"asc""desc"
order[updatedAt]string
Default "asc"
Enum"asc""desc"
searchstring

Global case-insensitive text search.

idinteger
id[]Array of integers
uuidstring
uuid[]Array of strings
organizationstring
organization[]Array of strings
user.emailstring
user.email[]Array of strings
user.uuidstring
user.uuid[]Array of strings
urlstring
url[]Array of strings
certificateVerificationDisabledboolean
certificateVerificationDisabled[]Array of booleans
enabledboolean
enabled[]Array of booleans
subscriptionsstring
createdAt[between]string
createdAt[gt]string
createdAt[gte]string
createdAt[lt]string
createdAt[lte]string
updatedAt[between]string
updatedAt[gt]string
updatedAt[gte]string
updatedAt[lt]string
updatedAt[lte]string
curl -i -X GET \
  'https://api.askara.ai/webhooks?page=1&itemsPerPage=20&order%5Bid%5D=asc&order%5Buuid%5D=asc&order%5Burl%5D=asc&order%5Bsecret%5D=asc&order%5BcertificateVerificationDisabled%5D=asc&order%5Benabled%5D=asc&order%5Bsubscriptions%5D=asc&order%5BcreatedAt%5D=asc&order%5BupdatedAt%5D=asc&search=string&id=0&id%5B%5D=0&uuid=string&uuid%5B%5D=string&organization=string&organization%5B%5D=string&user.email=string&user.email%5B%5D=string&user.uuid=string&user.uuid%5B%5D=string&url=string&url%5B%5D=string&certificateVerificationDisabled=true&certificateVerificationDisabled%5B%5D=true&enabled=true&enabled%5B%5D=true&subscriptions=string&createdAt%5Bbetween%5D=string&createdAt%5Bgt%5D=string&createdAt%5Bgte%5D=string&createdAt%5Blt%5D=string&createdAt%5Blte%5D=string&updatedAt%5Bbetween%5D=string&updatedAt%5Bgt%5D=string&updatedAt%5Bgte%5D=string&updatedAt%5Blt%5D=string&updatedAt%5Blte%5D=string'

Responses

Webhook collection

Body
Array [
uuidstring or null(uuid)

Webhook unique identifier.

organizationstring or null(iri-reference)
Example: "https://example.com/"
userstring or null(iri-reference)
Example: "https://example.com/"
enabledboolean
Default true
Example: true
createdAtstring(date-time)

Webhook creation date.

updatedAtstring(date-time)

Webhook update date.

]
Response
[
  {
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "organization": "https://example.com/",
    "user": "https://example.com/",
    "enabled": true,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
]

Create a webhook.

Request

Use this endpoint to create a webhook entity.

Body
required

The new Webhook resource

urlstring or null(uri)required
https://schema.org/url
subscriptionsstring or nullrequired
curl -i -X POST \
  https://api.askara.ai/webhooks \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "http://example.com",
    "subscriptions": "string"
  }'

Responses

Webhook resource created

Body
uuidstring or null(uuid)

Webhook unique identifier.

organizationstring or null(iri-reference)
Example: "https://example.com/"
userstring or null(iri-reference)
Example: "https://example.com/"
urlstring(uri)<= 500 charactersrequired
https://schema.org/url
secretstring or null
certificateVerificationDisabledboolean or null
enabledboolean
Default true
Example: true
subscriptionsArray of objects or null(WebhookSubscription-webhook.read)

Webhook subscriptions.

Enum"new_document""new_patient""new_contact"null
createdAtstring(date-time)

Webhook creation date.

updatedAtstring(date-time)

Webhook update date.

Response
{
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  "organization": "https://example.com/",
  "user": "https://example.com/",
  "url": "http://example.com",
  "secret": "string",
  "certificateVerificationDisabled": true,
  "enabled": true,
  "subscriptions": [
    {}
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Retrieve a webhook.

Request

Use this endpoint to retrieve a webhook information.

Path
uuidstringrequired

Webhook identifier

curl -i -X GET \
  'https://api.askara.ai/webhooks/{uuid}'

Responses

Webhook resource

Body
uuidstring or null(uuid)

Webhook unique identifier.

organizationstring or null(iri-reference)
Example: "https://example.com/"
userstring or null(iri-reference)
Example: "https://example.com/"
urlstring(uri)<= 500 charactersrequired
https://schema.org/url
secretstring or null
certificateVerificationDisabledboolean or null
enabledboolean
Default true
Example: true
subscriptionsArray of objects or null(WebhookSubscription-webhook.read)

Webhook subscriptions.

Enum"new_document""new_patient""new_contact"null
createdAtstring(date-time)

Webhook creation date.

updatedAtstring(date-time)

Webhook update date.

Response
{
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  "organization": "https://example.com/",
  "user": "https://example.com/",
  "url": "http://example.com",
  "secret": "string",
  "certificateVerificationDisabled": true,
  "enabled": true,
  "subscriptions": [
    {}
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Delete a webhook.

Request

Use this endpoint to delete a webhook entity.

Path
uuidstringrequired

Webhook identifier

curl -i -X DELETE \
  'https://api.askara.ai/webhooks/{uuid}'

Responses

Webhook resource deleted

Response
No content

Patch a webhook.

Request

Use this endpoint to update a webhook entity.

Path
uuidstringrequired

Webhook identifier

Bodyapplication/merge-patch+jsonrequired

The updated Webhook resource

urlstring(uri)<= 500 charactersrequired
https://schema.org/url
certificateVerificationDisabledboolean or null
enabledboolean
Default true
Example: true
subscriptionsArray of objects or null(WebhookSubscription-webhook.update)

Webhook subscriptions.

Enum"new_document""new_patient""new_contact"null
curl -i -X PATCH \
  'https://api.askara.ai/webhooks/{uuid}' \
  -H 'Content-Type: application/merge-patch+json' \
  -d '{
    "url": "http://example.com",
    "certificateVerificationDisabled": true,
    "enabled": true,
    "subscriptions": [
      {}
    ]
  }'

Responses

Webhook resource updated

Body
uuidstring or null(uuid)

Webhook unique identifier.

organizationstring or null(iri-reference)
Example: "https://example.com/"
userstring or null(iri-reference)
Example: "https://example.com/"
urlstring(uri)<= 500 charactersrequired
https://schema.org/url
secretstring or null
certificateVerificationDisabledboolean or null
enabledboolean
Default true
Example: true
subscriptionsArray of objects or null(WebhookSubscription-webhook.read)

Webhook subscriptions.

Enum"new_document""new_patient""new_contact"null
createdAtstring(date-time)

Webhook creation date.

updatedAtstring(date-time)

Webhook update date.

Response
{
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  "organization": "https://example.com/",
  "user": "https://example.com/",
  "url": "http://example.com",
  "secret": "string",
  "certificateVerificationDisabled": true,
  "enabled": true,
  "subscriptions": [
    {}
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}