logo
API docs by Redocly

Journal API specification (671ffd1c4b28d8ad24b1365b268d4186c500faa2)

Download OpenAPI specification:Download

The journal service is used to configure and manage journals.

categories

Returns a list of categories for the given organization.

When given limit and offset parameters, output is limited to those values.

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
required
integer
limit
integer [ 1 .. 50 ]
Default: 10

limits paginated output to passed amount

offset
integer >= 0
Default: 0

defines the offset for pagination

all
boolean
Default: false

returns all entries, ignoring limit and offset parameters

Responses

Response samples

Content type
application/json
[
  • {
    }
]

CreateCategory

Creates a new category

Authorizations:
API_TokenPersonal-Access-Token
Request Body schema: application/json
required
description
string
id
integer <int64>
name
required
string
organizationId
required
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "id": 0,
  • "name": "string",
  • "organizationId": 0
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": 0,
  • "name": "string",
  • "organizationId": 0
}

GetCategory

Returns requested category

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
categoryID
required
integer

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": 0,
  • "name": "string",
  • "organizationId": 0
}

UpdateCategory

Updates an existing category

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
categoryID
required
integer
Request Body schema: application/json
required
description
string
id
integer <int64>
name
required
string
organizationId
required
integer <int64>

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "id": 0,
  • "name": "string",
  • "organizationId": 0
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": 0,
  • "name": "string",
  • "organizationId": 0
}

DeleteCategory

Deletes an existing category

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
categoryID
required
integer

Responses

journals

GetJournal

Returns the requested journal including all entries with pagination

Authorizations:
API_TokenPersonal-Access-Token
query Parameters
organization_id
integer

use this parameter to query the journal of the given organization

event_id
integer

use this parameter to query the journal of the given event

limit
integer [ 1 .. 50 ]
Default: 10

limits paginated output to passed amount

offset
integer >= 0
Default: 0

defines the offset for pagination

all
boolean
Default: false

returns all entries, ignoring limit and offset parameters

Responses

Response samples

Content type
application/json
{
  • "closed": true,
  • "entryList": {
    },
  • "eventId": 0,
  • "id": 0,
  • "locked": {
    },
  • "organizationId": 0
}

LockJournal

Locks an existing journal

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
journalID
required
integer

Responses

UnlockJournal

Unlocks an existing journal

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
journalID
required
integer

Responses

entries

CreateEntry

Creates a new entry in an existing journal

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
journalID
required
integer
Request Body schema: application/json
required
attachment
string
categoryId
required
integer <int64>
customTime
any
journalId
required
integer <int64>
location
string
text
required
string

Responses

Request samples

Content type
application/json
{
  • "attachment": "string",
  • "categoryId": 0,
  • "customTime": null,
  • "journalId": 0,
  • "location": "string",
  • "text": "string"
}

Response samples

Content type
application/json
{
  • "attachment": "string",
  • "category": {
    },
  • "created": {
    },
  • "deleted": {
    },
  • "id": 0,
  • "journalId": 0,
  • "location": "string",
  • "serialNumber": 0,
  • "text": "string"
}

DeleteEntry

Deletes an existing journal entry

Authorizations:
API_TokenPersonal-Access-Token
path Parameters
journalID
required
integer
entryID
required
integer

Responses