An email object represents emails sent to Rossum inboxes.
ID of the email
URL of the email
Queue URL.
URL of the associated inbox
URL of the parent email
URL of the associated email thread
List of URLs of the children emails
List of documents attached to email
Timestamp of incoming email
(Deprecated) Timestamp of the most recent email in this email thread
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}Email type. Can be incoming or outgoing
List of URLs of annotations that arrived via email
List of URLs of annotations that are related to the email (e.g. rejected by that, added as attachment etc.)
List of URLs of documents related to the email (e.g. by forwarding email containing document as attachment etc.)
User that have sent the email. null if email has been received via SMTP
This attribute is intended for INTERNAL use only and may be changed in the future without notice. Number of documents automatically filtered out by Rossum smart inbox (this feature can be configured in inbox settings).
List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
List emails
Retrieve all emails objects.
curl -X GET "https://example.rossum.app/api/v1/emails?id=1%2C2%2C3&queue=1%2C2%2C3"{
"pagination": {
"total": 1,
"total_pages": 1,
"next": null,
"previous": null
},
"results": [
{
"id": 1234,
"url": "https://example.rossum.app/api/v1/emails/1234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"inbox": "https://example.rossum.app/api/v1/inboxes/1229",
"parent": "https://example.rossum.app/api/v1/emails/1234",
"email_thread": "https://example.rossum.app/api/v1/email_threads/456",
"children": [
"https://example.rossum.app/api/v1/emails/1244"
],
"documents": [
"https://example.rossum.app/api/v1/documents/5678"
],
"created_at": "2021-03-26T14:31:46.993427Z",
"last_thread_email_created_at": "2021-03-27T14:29:48.665478Z",
"subject": "Some email subject",
"from": {
"email": "company@east-west.com",
"name": "Company East"
},
"to": [
{
"email": "east-west-trading-co-a34f3a@example.rossum.app",
"name": "East West Trading"
}
],
"cc": [],
"bcc": [],
"body_text_plain": "Some body",
"body_text_html": "<div dir=\"ltr\">Some body</div>",
"metadata": {
"some_key": "some_value"
},
"type": "outgoing",
"annotation_counts": {
"annotations": 3,
"annotations_processed": 1,
"annotations_purged": 0,
"annotations_unprocessed": 1,
"annotations_rejected": 1,
"related_annotations": 0
},
"annotations": [
"https://example.rossum.app/api/v1/annotations/1",
"https://example.rossum.app/api/v1/annotations/2",
"https://example.rossum.app/api/v1/annotations/4"
],
"related_annotations": [],
"related_documents": [
"https://example.rossum.app/api/v1/documents/3"
],
"creator": "https://example.rossum.app/api/v1/users/10775",
"filtered_out_document_count": 2,
"labels": [
"rejected"
],
"content": "https://example.rossum.app/api/v1/emails/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
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
Retrieve email
Get an email object.
curl -X GET "https://example.rossum.app/api/v1/emails/1234"{
"id": 1234,
"url": "https://example.rossum.app/api/v1/emails/1234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"inbox": "https://example.rossum.app/api/v1/inboxes/1229",
"parent": "https://example.rossum.app/api/v1/emails/1234",
"email_thread": "https://example.rossum.app/api/v1/email_threads/456",
"children": [
"https://example.rossum.app/api/v1/emails/1244"
],
"documents": [
"https://example.rossum.app/api/v1/documents/5678"
],
"created_at": "2021-03-26T14:31:46.993427Z",
"last_thread_email_created_at": "2021-03-27T14:29:48.665478Z",
"subject": "Some email subject",
"from": {
"email": "company@east-west.com",
"name": "Company East"
},
"to": [
{
"email": "east-west-trading-co-a34f3a@example.rossum.app",
"name": "East West Trading"
}
],
"cc": [],
"bcc": [],
"body_text_plain": "Some body",
"body_text_html": "<div dir=\"ltr\">Some body</div>",
"metadata": {
"some_key": "some_value"
},
"type": "outgoing",
"annotation_counts": {
"annotations": 3,
"annotations_processed": 1,
"annotations_purged": 0,
"annotations_unprocessed": 1,
"annotations_rejected": 1,
"related_annotations": 0
},
"annotations": [
"https://example.rossum.app/api/v1/annotations/1",
"https://example.rossum.app/api/v1/annotations/2",
"https://example.rossum.app/api/v1/annotations/4"
],
"related_annotations": [],
"related_documents": [
"https://example.rossum.app/api/v1/documents/3"
],
"creator": "https://example.rossum.app/api/v1/users/10775",
"filtered_out_document_count": 2,
"labels": [
"rejected"
],
"content": "https://example.rossum.app/api/v1/emails/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
OK
ID of the email
URL of the email
Queue URL.
URL of the associated inbox
URL of the parent email
URL of the associated email thread
List of URLs of the children emails
List of documents attached to email
Timestamp of incoming email
(Deprecated) Timestamp of the most recent email in this email thread
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}Email type. Can be incoming or outgoing
List of URLs of annotations that arrived via email
List of URLs of annotations that are related to the email (e.g. rejected by that, added as attachment etc.)
List of URLs of documents related to the email (e.g. by forwarding email containing document as attachment etc.)
User that have sent the email. null if email has been received via SMTP
This attribute is intended for INTERNAL use only and may be changed in the future without notice. Number of documents automatically filtered out by Rossum smart inbox (this feature can be configured in inbox settings).
List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
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 email
Update part of email object.
curl -X PATCH "https://example.rossum.app/api/v1/emails/1234" \ -H "Content-Type: application/json" \ -d '{}'{
"id": 1234,
"url": "https://example.rossum.app/api/v1/emails/1234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"inbox": "https://example.rossum.app/api/v1/inboxes/1229",
"parent": "https://example.rossum.app/api/v1/emails/1234",
"email_thread": "https://example.rossum.app/api/v1/email_threads/456",
"children": [
"https://example.rossum.app/api/v1/emails/1244"
],
"documents": [
"https://example.rossum.app/api/v1/documents/5678"
],
"created_at": "2021-03-26T14:31:46.993427Z",
"last_thread_email_created_at": "2021-03-27T14:29:48.665478Z",
"subject": "Some email subject",
"from": {
"email": "company@east-west.com",
"name": "Company East"
},
"to": [
{
"email": "east-west-trading-co-a34f3a@example.rossum.app",
"name": "East West Trading"
}
],
"cc": [],
"bcc": [],
"body_text_plain": "Some body",
"body_text_html": "<div dir=\"ltr\">Some body</div>",
"metadata": {
"some_key": "some_value"
},
"type": "outgoing",
"annotation_counts": {
"annotations": 3,
"annotations_processed": 1,
"annotations_purged": 0,
"annotations_unprocessed": 1,
"annotations_rejected": 1,
"related_annotations": 0
},
"annotations": [
"https://example.rossum.app/api/v1/annotations/1",
"https://example.rossum.app/api/v1/annotations/2",
"https://example.rossum.app/api/v1/annotations/4"
],
"related_annotations": [],
"related_documents": [
"https://example.rossum.app/api/v1/documents/3"
],
"creator": "https://example.rossum.app/api/v1/users/10775",
"filtered_out_document_count": 2,
"labels": [
"rejected"
],
"content": "https://example.rossum.app/api/v1/emails/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": "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.
URL of the associated inbox
URL of the parent email
List of URLs of the children emails
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
Response
OK
ID of the email
URL of the email
Queue URL.
URL of the associated inbox
URL of the parent email
URL of the associated email thread
List of URLs of the children emails
List of documents attached to email
Timestamp of incoming email
(Deprecated) Timestamp of the most recent email in this email thread
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}Email type. Can be incoming or outgoing
List of URLs of annotations that arrived via email
List of URLs of annotations that are related to the email (e.g. rejected by that, added as attachment etc.)
List of URLs of documents related to the email (e.g. by forwarding email containing document as attachment etc.)
User that have sent the email. null if email has been received via SMTP
This attribute is intended for INTERNAL use only and may be changed in the future without notice. Number of documents automatically filtered out by Rossum smart inbox (this feature can be configured in inbox settings).
List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
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
Update email
Update email object.
curl -X PUT "https://example.rossum.app/api/v1/emails/1234" \ -H "Content-Type: application/json" \ -d '{ "queue": "https://example.rossum.app/api/v1/queues/8198", "inbox": "https://example.rossum.app/api/v1/inboxes/1229" }'{
"id": 1234,
"url": "https://example.rossum.app/api/v1/emails/1234",
"queue": "https://example.rossum.app/api/v1/queues/8198",
"inbox": "https://example.rossum.app/api/v1/inboxes/1229",
"parent": "https://example.rossum.app/api/v1/emails/1234",
"email_thread": "https://example.rossum.app/api/v1/email_threads/456",
"children": [
"https://example.rossum.app/api/v1/emails/1244"
],
"documents": [
"https://example.rossum.app/api/v1/documents/5678"
],
"created_at": "2021-03-26T14:31:46.993427Z",
"last_thread_email_created_at": "2021-03-27T14:29:48.665478Z",
"subject": "Some email subject",
"from": {
"email": "company@east-west.com",
"name": "Company East"
},
"to": [
{
"email": "east-west-trading-co-a34f3a@example.rossum.app",
"name": "East West Trading"
}
],
"cc": [],
"bcc": [],
"body_text_plain": "Some body",
"body_text_html": "<div dir=\"ltr\">Some body</div>",
"metadata": {
"some_key": "some_value"
},
"type": "outgoing",
"annotation_counts": {
"annotations": 3,
"annotations_processed": 1,
"annotations_purged": 0,
"annotations_unprocessed": 1,
"annotations_rejected": 1,
"related_annotations": 0
},
"annotations": [
"https://example.rossum.app/api/v1/annotations/1",
"https://example.rossum.app/api/v1/annotations/2",
"https://example.rossum.app/api/v1/annotations/4"
],
"related_annotations": [],
"related_documents": [
"https://example.rossum.app/api/v1/documents/3"
],
"creator": "https://example.rossum.app/api/v1/users/10775",
"filtered_out_document_count": 2,
"labels": [
"rejected"
],
"content": "https://example.rossum.app/api/v1/emails/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": "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.
URL of the associated inbox
URL of the parent email
List of URLs of the children emails
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
Response
OK
ID of the email
URL of the email
Queue URL.
URL of the associated inbox
URL of the parent email
URL of the associated email thread
List of URLs of the children emails
List of documents attached to email
Timestamp of incoming email
(Deprecated) Timestamp of the most recent email in this email thread
Email subject
Plain text email section (shortened to 4kB)
HTML email section (shortened to 4kB)
Client data. May be used to store e.g. external system object IDs. See Metadata for more details.
Default:{}Email type. Can be incoming or outgoing
List of URLs of annotations that arrived via email
List of URLs of annotations that are related to the email (e.g. rejected by that, added as attachment etc.)
List of URLs of documents related to the email (e.g. by forwarding email containing document as attachment etc.)
User that have sent the email. null if email has been received via SMTP
This attribute is intended for INTERNAL use only and may be changed in the future without notice. Number of documents automatically filtered out by Rossum smart inbox (this feature can be configured in inbox settings).
List of email labels. Email objects can have assigned any number of labels.
| Label name | Description |
|---|---|
| rejection | Outgoing informative email sent by Rossum after email was manually rejected. |
| automatic_rejection | Informative automatic email sent by Rossum when no document was extracted from incoming email. |
| automatic_status_changed_info | Informative automatic email sent by Rossum about document status change. |
| rejected | Incoming email rejected together with all attached documents. |
| forwarded | Outgoing email sent by forwarding other email. |
| reply | Outgoing email sent by replying to another email. |
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
Import email
Import an email as raw data. Calling this endpoint starts an asynchronous process of creating
an email object and importing its contents to the specified recipient inbox in Rossum. This endpoint
can be used only by admin and organization_group_admin roles and email can be imported only to
inboxes within the organization. The caller of this endpoint will be specified as the creator of the email.
The email sender specified in the from header will still receive any automated notifications targeted to the
email recipients.
Import email endpoint is asynchronous and response contains created task url. Further information about the import status may be acquired by retrieving the email object or the task (for more information, please refer to task
curl -X POST "https://example.rossum.app/api/v1/emails/import" \ -F raw_message="string" \ -F recipient="user@example.com"{
"url": "https://example.rossum.app/api/v1/tasks/1"
}{
"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
multipart/form-data
Raw email data.
Email address of the inbox where the email will be imported.
JSON object with metadata to be set on created annotations.
JSON object with values to be set on created annotations. All keys must start with the emails_import: prefix (e.g., emails_import:customer_id).
Response
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 email content
Retrieve content of email.
Email content is unprocessed, unsanitized content and may contain possibly dangerous attachments. Be cautious while working with it.
curl -X GET "https://example.rossum.app/api/v1/emails/1234/content""string"{
"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
responsestring (binary)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
Send email
Send email to specified recipients. The number of emails that can be sent is limited (10 for trials accounts).
At least one email in to, cc, bcc must be filled. The total number of recipients (to, cc and bcc together) cannot exceed 40.
If the related annotation has null email thread, it will be linked to the email thread related to the email created.
Template values
The object template_values is used to create an outgoing email. Key subject is used to fill an email subject and message is used to fill a body of the email (it may contain a subset of HTML). Values may contain other placeholders that are either built-in (see below) or specified in the template_values. For placeholders referring to annotations, the annotations from related_annotations attribute are used for filling in correct values.
List of built-in placeholders
| Placeholder | Description | Can be used in automation |
|---|---|---|
| organization_name | Name of the organization. | True |
| app_url | App root url | True |
| user_name | Username of the user sending the email. | False |
| current_user_fullname | Full name of user sending the email. | False |
| current_user_email | Email address of the user sending the email. | False |
| parent_email_subject | Subject of the email we are replying to. | True |
| sender_email | Email address of the author of the incoming email. | True |
| annotation.document.original_file_name | Filenames of the documents belonging to the related annotation(s) | True |
| annotation.content.value.{schema_id} | Content value of datapoints from email related annotation(s) | True |
| annotation.id | IDs of the related annotation(s) | True |
| annotation.url | Urls of the related annotation(s) | True |
| annotation.assignee_email | Emails of the assigned users to the related annotation(s) | True |
curl -X POST "https://example.rossum.app/api/v1/emails/send" \ -H "Content-Type: application/json" \ -d '{ "queue": "https://example.rossum.app/api/v1/queues/8198" }'{
"url": "https://example.rossum.app/api/v1/emails/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": "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.
List of links to email-related annotations.
List of URLs to email-related documents (on the top of related_annotations documents which are linked automatically).
Link to parent email.
Update related annotations, so that their email thread matches the one of the email object created.
List of email labels.
Link to the email template that was used for the email creation. If specified, the email will be included in the email templates stats.
Response
OK
URL of the created email
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