Bundeling

Bulletinboard categories

list

Retrieves a collection of bulletinboard categories and rudimentary information about them.

single

Retrieves a single bulletinboard category and rudimentary information about it.

create

Creates a new bulletinboard category. Only available to API keys without user authentication.

update

Updates an existing bulletinboard category. Only available to API keys without user authentication.

delete

Deletes a single bulletinboard category. Only available to API keys without user authentication.

Json

XML

PUT https://api.bundeling.com/V2/bulletinboard_categories

Parameters

Url

Name	Description	Type
`uuid`	A unique identifier used to identify a bulletinboard category	`string`

Body

Name	Description	Type	Nillable
`bulletinboard_uuid`	A unique identifier used to identify a bulletinboard	`string`	`false`
`name`	The name for the category	`string`	`false`
`icon`	Which icon to display with the category	`string`	`false`
`position`	The position to show this category in lists	`int`	`false`
`labels`	Labels to add to this category. Replaces current labels	`array(string)`	`false`
`external_reference`	Reference for linking to external systems.	`string`	`false`

Example request

Choose language

Headers

Body

{
    "bulletinboard_uuid": "SEFryszojAGSadgOrdghIJij2dfg",
    "name": "Job openings",
    "icon": "tag",
    "position": 3,
    "labels": [
        "eeb763c41c054dcc8f6d9362f24ee9b2"
    ],
    "external_reference": "123908"
}

Example response

{
    "uuid": "eeb763c41c054dcc8f6d9362f24ee9b2",
    "bulletinboard_uuid": "56f09a35ea14453ba94bc2b2add19a23",
    "name": "Job openings",
    "icon": "tag",
    "position": 3,
    "labels": [
        "d7743aaf53224e279853c7d0c1dbfb3a",
        "d7743aaf53224e279853c7d0c1dbfb3a"
    ],
    "combined_labels": {
        "uuid": "d7743aaf53224e279853c7d0c1dbfb3a",
        "labels": [
            "d7743aaf53224e279853c7d0c1dbfb3a",
            "d7743aaf53224e279853c7d0c1dbfb3a"
        ]
    },
    "external_reference": "123908",
    "creationdate": "2024-01-20T00:00:00+0100",
    "lastupdate": "2024-01-20T00:00:00+0100"
}