Relationships

get

Authorizations

Basic

AuthorizationstringRequired

Query parameters

orderingstringOptional

Which field to use when ordering the results.

aspect_typestring · enumOptional

aspect_type

Possible values:

is_privatestringOptional

is_private

from_content_typestringOptional

from_content_type

to_content_typestringOptional

to_content_type

from_object_idstringOptional

from_object_id

to_object_idstringOptional

to_object_id

pageintegerOptional

Page number to retrieve (1-indexed).

page_sizeintegerOptional

Number of results per page. Defaults to the pagination class's page size and respects the configured maximum.

Responses

200Success

application/json

get

/relationships/

HTTPcURLJavaScriptPython

GET /public/relationships/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

200Success

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "id": 1,
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "from_content_type": 1,
      "from_object_id": 1,
      "to_content_type": 1,
      "to_object_id": 1,
      "from_entity": {},
      "to_entity": {},
      "aspect_type": "mentor",
      "strength": 1,
      "start_date": "2026-01-20",
      "end_date": "2026-01-20",
      "meta": {},
      "is_private": true,
      "created": "2026-01-20T18:49:45.281Z",
      "modified": "2026-01-20T18:49:45.281Z",
      "role_contexts": [
        {
          "id": 1,
          "relationship": 1,
          "relationship_uuid": "123e4567-e89b-12d3-a456-426614174000",
          "relationship_role": "text",
          "description": "text",
          "created": "2026-01-20T18:49:45.281Z",
          "modified": "2026-01-20T18:49:45.281Z"
        }
      ],
      "current_state": {}
    }
  ]
}

post

Authorizations

Basic

AuthorizationstringRequired

Body

application/json

entity_typestring · enumRequiredPossible values:

from_idintegerRequired

to_idintegerRequired

start_datestring · dateRequired

end_datestring · date | nullableOptional

aspect_typestring · enum | nullableOptionalPossible values:

strengthnumber | nullableOptional

is_privatebooleanOptionalDefault: false

Responses

201Success

application/json

post

/relationships/

HTTPcURLJavaScriptPython

POST /public/relationships/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "entity_type": "person",
  "from_id": 1,
  "to_id": 1,
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": false,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

201Success

{
  "entity_type": "person",
  "from_id": 1,
  "to_id": 1,
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": false,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

get

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Responses

200Success

application/json

get

/relationships/{id}/

HTTPcURLJavaScriptPython

GET /public/relationships/{id}/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

200Success

{
  "id": 1,
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "from_content_type": 1,
  "from_object_id": 1,
  "to_content_type": 1,
  "to_object_id": 1,
  "from_entity": {},
  "to_entity": {},
  "aspect_type": "mentor",
  "strength": 1,
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "meta": {},
  "is_private": true,
  "created": "2026-01-20T18:49:45.281Z",
  "modified": "2026-01-20T18:49:45.281Z",
  "role_contexts": [
    {
      "id": 1,
      "relationship": 1,
      "relationship_uuid": "123e4567-e89b-12d3-a456-426614174000",
      "relationship_role": "text",
      "description": "text",
      "created": "2026-01-20T18:49:45.281Z",
      "modified": "2026-01-20T18:49:45.281Z"
    }
  ],
  "current_state": {}
}

put

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Body

application/json

start_datestring · dateOptional

end_datestring · date | nullableOptional

aspect_typestring · enum | nullableOptionalPossible values:

strengthnumber | nullableOptional

is_privatebooleanOptional

Responses

200Success

application/json

put

/relationships/{id}/

HTTPcURLJavaScriptPython

PUT /public/relationships/{id}/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": true,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

200Success

{
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": true,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

delete

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Responses

204Success

delete

/relationships/{id}/

HTTPcURLJavaScriptPython

DELETE /public/relationships/{id}/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

204Success

No content

patch

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Body

application/json

start_datestring · dateOptional

end_datestring · date | nullableOptional

aspect_typestring · enum | nullableOptionalPossible values:

strengthnumber | nullableOptional

is_privatebooleanOptional

Responses

200Success

application/json

patch

/relationships/{id}/

HTTPcURLJavaScriptPython

PATCH /public/relationships/{id}/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 147

{
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": true,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

200Success

{
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "aspect_type": "mentor",
  "strength": 1,
  "is_private": true,
  "meta": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

get

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Query parameters

pageintegerOptional

Page number to retrieve (1-indexed).

page_sizeintegerOptional

Number of results per page. Defaults to the pagination class's page size and respects the configured maximum.

Responses

200Success

application/json

get

/relationships/{id}/state-history/

HTTPcURLJavaScriptPython

GET /public/relationships/{id}/state-history/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

200Success

{
  "id": 1,
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "from_content_type": 1,
  "from_object_id": 1,
  "to_content_type": 1,
  "to_object_id": 1,
  "from_entity": {},
  "to_entity": {},
  "aspect_type": "mentor",
  "strength": 1,
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "meta": {},
  "is_private": true,
  "created": "2026-01-20T18:49:45.281Z",
  "modified": "2026-01-20T18:49:45.281Z",
  "role_contexts": [
    {
      "id": 1,
      "relationship": 1,
      "relationship_uuid": "123e4567-e89b-12d3-a456-426614174000",
      "relationship_role": "text",
      "description": "text",
      "created": "2026-01-20T18:49:45.281Z",
      "modified": "2026-01-20T18:49:45.281Z"
    }
  ],
  "current_state": {}
}