Sign in
latestOpenAPI 3.0.02026-08-0819201.1 MB

411f9f98c01e

topics

Creates a topic

You need workspaces.topic.create permission to access this resource

post/workspaces/{workspace_id}/topics

Path parameters

workspace_idstring required

Workspace identifier

Request body

Example request

{
  "data": {
    "id": "5b4f337bff4304610483ba67",
    "links": {
      "self": "/v2/topics/5b4f337bff4304610483ba67"
    },
    "attributes": {
      "name": "Topic name"
    },
    "relationships": {
      "workspace": {
        "data": {
          "id": "5b4f337bff4304610483ba67"
        },
        "links": {
          "self": "/v2/workspaces/5b4f337bff4304610483ba67"
        }
      },
      "user": {
        "data": {
          "id": "5b4f337bff4304610483ba67"
        },
        "links": {
          "self": "/v2/users/5b4f337bff4304610483ba67"
        }
      }
    }
  }
}

Response

Created

metaobject required

Example response

{
  "data": {
    "id": "5b4f337bff4304610483ba67",
    "links": {
      "self": "/v2/topics/5b4f337bff4304610483ba67"
    },
    "attributes": {
      "name": "Topic name"
    },
    "relationships": {
      "workspace": {
        "data": {
          "id": "5b4f337bff4304610483ba67"
        },
        "links": {
          "self": "/v2/workspaces/5b4f337bff4304610483ba67"
        }
      },
      "user": {
        "data": {
          "id": "5b4f337bff4304610483ba67"
        },
        "links": {
          "self": "/v2/users/5b4f337bff4304610483ba67"
        }
      }
    }
  }
}