ROrossum
Relation

Create relation

Changed on

Create a new relation object.

post/api/v1/relations

Request

Request body

idinteger

ID of the relation

type'edit' | 'attachment' | 'duplicate'

Type of relationship. Possible values are: edit, attachment, duplicate.

  • edit relation is created after editing annotation in user interface (rotation or split of the document)
  • attachment is a relationship representing the state that one or more documents are attachments to another document
  • duplicate relation is created after importing the same document that already exists in Rossum for current organization
keystring nullable

Key used to distinguish several instances of the same type.

  • For attachment relations, this is null
  • For duplicate relations, this is set to a hash of document content
  • For edit relations, this is typically null
parentstring uri nullable

URL of the parent annotation in case of 1-M relationship

annotationsstring[]

List of related annotations

urlstring uri

URL of the relation

Example request

{
  "id": 1,
  "type": "edit",
  "parent": "https://example.rossum.app/api/v1/annotations/123",
  "annotations": [
    "https://example.rossum.app/api/v1/annotations/124",
    "https://example.rossum.app/api/v1/annotations/125"
  ],
  "url": "https://example.rossum.app/api/v1/relations/1"
}

Response

Created

idinteger required

ID of the relation

type'edit' | 'attachment' | 'duplicate' required

Type of relationship. Possible values are: edit, attachment, duplicate.

  • edit relation is created after editing annotation in user interface (rotation or split of the document)
  • attachment is a relationship representing the state that one or more documents are attachments to another document
  • duplicate relation is created after importing the same document that already exists in Rossum for current organization
keystring nullable required

Key used to distinguish several instances of the same type.

  • For attachment relations, this is null
  • For duplicate relations, this is set to a hash of document content
  • For edit relations, this is typically null
parentstring uri nullable required

URL of the parent annotation in case of 1-M relationship

annotationsstring[] required

List of related annotations

urlstring uri required

URL of the relation

Example response

{
  "id": 1,
  "type": "edit",
  "parent": "https://example.rossum.app/api/v1/annotations/123",
  "annotations": [
    "https://example.rossum.app/api/v1/annotations/124",
    "https://example.rossum.app/api/v1/annotations/125"
  ],
  "url": "https://example.rossum.app/api/v1/relations/1"
}

Changes

  • f1b5a910991dRevision changes
    • breaking

      the response's body type changed from object to no type for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added subschema #2 to the response body allOf list for the response status