Post

A Post is a message published on a Board. It also provides notifications to Projects affected by the Post.

Package : spaceone.api.board.v1

Post

Post Methods:

create

Creates a new Post under a specific Board. You must specify the board_id, title, and contents. The parameter category is not required but can be set in the scope of categories specified in the parent Board. You can make the new Post pinned or pop up by adjusting the parameters.

POST /board/v1/post/create

{{< tabs " create " >}}

{{< tab "Request Example" >}}

CreatePostRequest

  • board_type (string) Required

  • title (string) Required

  • contents (string) Required

  • resource_group (ResourceGroup) Required

  • category (string)

  • files (string) Repeated

  • options (Struct)

  • writer (string)

  • workspaces (string) Repeated

{{< highlight json >}} { "board_type": "NOTICE", "category": "developer", "title": "title", "contents": "This is contents.", "files": ["file-123456789012"], "options": {"is_popup": true}, "writer": "user1", "resource_group": "DOMAIN", } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

PostInfo

  • board_type (string) Required

  • post_id (string) Required

  • category (string) Required

  • title (string) Required

  • contents (string) Required

  • options (Struct) Required

  • view_count (int32) Required

  • writer (string) Required

  • files (ListValue) Required

  • resource_group (ResourceGroup) Required

  • domain_id (string) Required

  • workspaces (string) Repeated Required

  • user_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "board_type": "NOTICE", "post_id": "post-123456789012", "category": "developer", "title": "title", "contents": "This is contents.", "options": { "is_pinned": false, "is_popup": true }, "view_count": 0, "writer": "user1", "resource_group": "DOMAIN", "domain_id": "domain-123456789012", "user_id": "user1@email.com", "created_at": "2022-01-01T01:06:23.732Z", "updated_at": "2022-01-01T01:06:23.732Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

update

Updates a specific Post. You can make changes in Post settings, except board_id, post_id, and domain_id.

POST /board/v1/post/update

{{< tabs " update " >}}

{{< tab "Request Example" >}}

UpdatePostRequest

  • post_id (string) Required

  • title (string)

  • contents (string)

  • category (string)

  • files (string) Repeated

  • options (Struct)

  • writer (string)

  • workspaces (string) Repeated

{{< highlight json >}} { "post_id": "post-2118473ce15e", "title": "title2", "contents": "this is contents2.", "category": "developer", "options": { "is_popup": false, "is_pinned": true }, "writer": "user1" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

PostInfo

  • board_type (string) Required

  • post_id (string) Required

  • category (string) Required

  • title (string) Required

  • contents (string) Required

  • options (Struct) Required

  • view_count (int32) Required

  • writer (string) Required

  • files (ListValue) Required

  • resource_group (ResourceGroup) Required

  • domain_id (string) Required

  • workspaces (string) Repeated Required

  • user_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "board_type": "NOTICE", "post_id": "post-123456789012", "category": "developer", "title": "title", "contents": "This is contents.", "options": { "is_pinned": false, "is_popup": true }, "view_count": 0, "writer": "user1", "resource_group": "DOMAIN", "domain_id": "domain-123456789012", "user_id": "user1@email.com", "created_at": "2022-01-01T01:06:23.732Z", "updated_at": "2022-01-01T01:06:23.732Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

send

Not Implemented

POST /board/v1/post/send

{{< tabs " send " >}}

{{< tab "Request Example" >}}

PostRequest

  • post_id (string) Required

{{< highlight json >}} { "post_id": "post-2118473ce15e" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

delete

Deletes a specific Post. You must specify the post_id of the Post to delete, and the board_id of the Board where the child Post to delete belongs.

POST /board/v1/post/delete

{{< tabs " delete " >}}

{{< tab "Request Example" >}}

PostRequest

  • post_id (string) Required

{{< highlight json >}} { "post_id": "post-2118473ce15e" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

get

Gets a specific Post. You must specify the post_id of the Post to get, and the board_id of the Board where the child Post to get belongs. Prints detailed information about the Post.

POST /board/v1/post/get

{{< tabs " get " >}}

{{< tab "Request Example" >}}

PostRequest

  • post_id (string) Required

{{< highlight json >}} { "post_id": "post-2118473ce15e" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

PostInfo

  • board_type (string) Required

  • post_id (string) Required

  • category (string) Required

  • title (string) Required

  • contents (string) Required

  • options (Struct) Required

  • view_count (int32) Required

  • writer (string) Required

  • files (ListValue) Required

  • resource_group (ResourceGroup) Required

  • domain_id (string) Required

  • workspaces (string) Repeated Required

  • user_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "board_type": "NOTICE", "post_id": "post-123456789012", "category": "developer", "title": "title", "contents": "This is contents.", "options": { "is_pinned": false, "is_popup": true }, "view_count": 0, "writer": "user1", "resource_group": "DOMAIN", "domain_id": "domain-123456789012", "user_id": "user1@email.com", "created_at": "2022-01-01T01:06:23.732Z", "updated_at": "2022-01-01T01:06:23.732Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

list

Gets a list of all Posts. You can use a query to get a filtered list of Posts.

POST /board/v1/post/list

{{< tabs " list " >}}

{{< tab "Request Example" >}}

PostSearchQuery

  • query (Query)

  • board_type (string)

  • post_id (string)

  • category (string)

  • writer (string)

  • is_pinned (bool)

  • is_popup (bool)

  • domain_id (string)

  • workspace_id (string)

{{< highlight json >}} { "query": {} } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

PostsInfo

  • results (PostInfo) Repeated Required

  • total_count (int32) Required

{{< highlight json >}} { "results": [ { "board_id": "board-b9aa34e65c60", "post_id": "post-2118473ce15e", "category": "spaceone", "title": "title2", "contents": "this is contents2.", "options": { "is_popup": false, "is_pinned": true }, "view_count": 3, "writer": "seolmin2", "files": ["file-123456789012"], "resource_group": "DOMAIN", "domain_id": "domain-58010aa2e451", "user_id": "user1@email.com", "created_at": "2022-06-13T01:06:23.732Z", "updated_at": "2022-06-13T01:06:23.732Z" }, { "board_id": "board-b9aa34e65c60", "post_id": "post-532ae1191233", "category": "flower", "title": "작업공지", "contents": "This is description", "options": { "is_pinned": true, "is_popup": true }, "writer": "권설민", "files": ["file-123456789022"], "resource_group": "DOMAIN", "user_id": "supervisor", "created_at": "2022-06-10T07:01:44.384Z", "updated_at": "2022-06-10T07:01:44.384Z" } ], "total_count": 2 } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

stat

POST /board/v1/post/stat

Message

CreatePostRequest

  • board_type (string) Required

  • title (string) Required

  • contents (string) Required

  • resource_group (ResourceGroup) Required

  • category (string)

  • files (string) Repeated

  • options (Struct)

  • writer (string)

  • workspaces (string) Repeated

PostInfo

  • board_type (string) Required

  • post_id (string) Required

  • category (string) Required

  • title (string) Required

  • contents (string) Required

  • options (Struct) Required

  • view_count (int32) Required

  • writer (string) Required

  • files (ListValue) Required

  • resource_group (ResourceGroup) Required

  • domain_id (string) Required

  • workspaces (string) Repeated Required

  • user_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

PostRequest

  • post_id (string) Required

PostSearchQuery

  • query (Query)

  • board_type (string)

  • post_id (string)

  • category (string)

  • writer (string)

  • is_pinned (bool)

  • is_popup (bool)

  • domain_id (string)

  • workspace_id (string)

PostStatQuery

  • query (StatisticsQuery) Required

PostsInfo

  • results (PostInfo) Repeated Required

  • total_count (int32) Required

UpdatePostRequest

  • post_id (string) Required

  • title (string)

  • contents (string)

  • category (string)

  • files (string) Repeated

  • options (Struct)

  • writer (string)

  • workspaces (string) Repeated

Last updated