Trigger
A Trigger object represents a condition that will trigger its related object's actions when an event occurs.
A Trigger with trigger event type of email_with_no_processable_attachments can be only retrieved. It can not be created, updated nor deleted.
Trigger
ID of the trigger
URL of the trigger
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
User that last modified the object.
Timestamp of last modification.
List triggers
GET api / v1 / triggers
Retrieve all trigger objects.
curl -X GET "https://example.rossum.app/api/v1/triggers"{
"results": [
{
"id": 234,
"url": "https://example.rossum.app/api/v1/triggers/234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"event": "annotation_imported",
"condition": {},
"email_templates": [
"https://example.rossum.app/api/v1/email_templates/123",
"https://example.rossum.app/api/v1/email_templates/321"
],
"delete_recommendations": [
"https://example.rossum.app/api/v1/delete_recommendations/123",
"https://example.rossum.app/api/v1/delete_recommendations/321"
],
"modified_by": "https://example.rossum.app/api/v1/users/10775",
"modified_at": "2021-04-26T10:08:03.856648Z"
}
],
"pagination": {
"next": null,
"previous": null
}
}{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Response
OK
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error
Create trigger
POST api / v1 / triggers
Create new trigger object.
curl -X POST "https://example.rossum.app/api/v1/triggers" \ -H "Content-Type: application/json" \ -d '{ "queue": "https://example.rossum.app/api/v1/queues/8198", "event": "annotation_imported" }'{
"id": 234,
"url": "https://example.rossum.app/api/v1/triggers/234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"event": "annotation_imported",
"condition": {},
"email_templates": [
"https://example.rossum.app/api/v1/email_templates/123",
"https://example.rossum.app/api/v1/email_templates/321"
],
"delete_recommendations": [
"https://example.rossum.app/api/v1/delete_recommendations/123",
"https://example.rossum.app/api/v1/delete_recommendations/321"
],
"modified_by": "https://example.rossum.app/api/v1/users/10775",
"modified_at": "2021-04-26T10:08:03.856648Z"
}{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Payload Too Large.",
"code": "payload_too_large"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Request Body
application/json
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
Response
Created
ID of the trigger
URL of the trigger
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
User that last modified the object.
Timestamp of last modification.
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Payload too large (especially for files uploaded).
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error
Retrieve trigger
GET api / v1 / triggers / {triggerID}
Get a trigger object.
curl -X GET "https://example.rossum.app/api/v1/triggers/1234"{
"id": 234,
"url": "https://example.rossum.app/api/v1/triggers/234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"event": "annotation_imported",
"condition": {},
"email_templates": [
"https://example.rossum.app/api/v1/email_templates/123",
"https://example.rossum.app/api/v1/email_templates/321"
],
"delete_recommendations": [
"https://example.rossum.app/api/v1/delete_recommendations/123",
"https://example.rossum.app/api/v1/delete_recommendations/321"
],
"modified_by": "https://example.rossum.app/api/v1/users/10775",
"modified_at": "2021-04-26T10:08:03.856648Z"
}{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Response
OK
ID of the trigger
URL of the trigger
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
User that last modified the object.
Timestamp of last modification.
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error
Partial update trigger
PATCH api / v1 / triggers / {triggerID}
Update part of a trigger object.
curl -X PATCH "https://example.rossum.app/api/v1/triggers/1234" \ -H "Content-Type: application/json" \ -d '{}'{
"id": 234,
"url": "https://example.rossum.app/api/v1/triggers/234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"event": "annotation_imported",
"condition": {},
"email_templates": [
"https://example.rossum.app/api/v1/email_templates/123",
"https://example.rossum.app/api/v1/email_templates/321"
],
"delete_recommendations": [
"https://example.rossum.app/api/v1/delete_recommendations/123",
"https://example.rossum.app/api/v1/delete_recommendations/321"
],
"modified_by": "https://example.rossum.app/api/v1/users/10775",
"modified_at": "2021-04-26T10:08:03.856648Z"
}{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Payload Too Large.",
"code": "payload_too_large"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Request Body
application/json
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
Response
OK
ID of the trigger
URL of the trigger
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
User that last modified the object.
Timestamp of last modification.
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Payload too large (especially for files uploaded).
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error
Delete trigger
DELETE api / v1 / triggers / {triggerID}
Delete a trigger object.
Trigger of email_with_no_processable_attachments event cannot be deleted.
curl -X DELETE "https://example.rossum.app/api/v1/triggers/1234"{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Response
No Content
No response body.
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error
Update trigger
PUT api / v1 / triggers / {triggerID}
Update trigger object.
curl -X PUT "https://example.rossum.app/api/v1/triggers/1234" \ -H "Content-Type: application/json" \ -d '{ "queue": "https://example.rossum.app/api/v1/queues/8198", "event": "annotation_imported" }'{
"id": 234,
"url": "https://example.rossum.app/api/v1/triggers/234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"event": "annotation_imported",
"condition": {},
"email_templates": [
"https://example.rossum.app/api/v1/email_templates/123",
"https://example.rossum.app/api/v1/email_templates/321"
],
"delete_recommendations": [
"https://example.rossum.app/api/v1/delete_recommendations/123",
"https://example.rossum.app/api/v1/delete_recommendations/321"
],
"modified_by": "https://example.rossum.app/api/v1/users/10775",
"modified_at": "2021-04-26T10:08:03.856648Z"
}{
"detail": "Bad Request.",
"code": "bad_request"
}{
"detail": "Invalid token.",
"code": "authentication_failed"
}{
"detail": "Access to the requested resource is forbidden.",
"code": "access_forbidden"
}{
"detail": "Not found.",
"code": "not_found"
}{
"detail": "Conflict.",
"code": "conflict_status"
}{
"detail": "Payload Too Large.",
"code": "payload_too_large"
}{
"detail": "Request was rate limited.",
"code": "rate_limited",
"url": "https://rossum.app/api/docs/openapi/guides/overview/#rate-limiting"
}{
"detail": "Server error.",
"code": "error"
}{
"detail": "Bad Gateway.",
"code": "bad_gateway"
}{
"detail": "Service Unavailable.",
"code": "service_unavailable"
}{
"detail": "Gateway timeout.",
"code": "gateway_timeout"
}Request Body
application/json
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
Response
OK
ID of the trigger
URL of the trigger
Queue URL.
URLs of the linked email templates
URLs of the linked delete recommendations
User that last modified the object.
Timestamp of last modification.
Invalid input data.
Detail of the error
Code of the error
The username/password is invalid or token is invalid (e.g. expired).
Detail of the error
Code of the error
Insufficient permission, missing authentication, invalid CSRF token and similar issue.
Detail of the error
Code of the error
The specified resource was not found.
Detail of the error
Code of the error
Conflict
Detail of the error
Code of the error
Payload too large (especially for files uploaded).
Detail of the error
Code of the error
Request rate is too high, wait before sending more requests. See Rate Limiting for more details.
Detail of the error
Code of the error
Link to the rate limiting documentation
Server failure while processing the request.
Detail of the error
Code of the error
Invalid response from the upstream server.
Detail of the error
Code of the error
We're temporarily offline for maintenance. Please try again later.
Detail of the error
Code of the error
Upstream server could not complete the request in time.
Detail of the error
Code of the error