DAdata
topics and comments - resource

Update an existing topic

This API enables users to modify details of a topic they have access to, identified by the owner's ID and the topic's UUID. This PUT request ensures that all changes comply with the required access permissions and topic visibility settings.

put/topics/{owner}/{topicUuid}

Request

  • Base URL
    https://api.data.world/v0
  • URL
    https://api.data.world/v0/topics/{owner}/{topicUuid}
  • Auth
    HTTP bearer

Path parameters

ownerstring required
topicUuidstring uuid required

Request body

defaultTopicboolean

True if this is the default topic for the specified resource. There should only be 1 topic with this field set per resource. Must be provided while creating a topic only.

titlestring
topicIdstring

Short friendly form of a topic id that uniquely identifies the topic within a resource.

topicSlugstring

Short friendly form of a topic title.

topicUuidstring uuid

Unique id of the topic generated while create new one. Returned for reference but must be provided through URL only.

visibility'DISCOVERABLE' | 'OPEN' | 'PRIVATE'

Topic visibility. The field is required.

Response

default response

defaultTopicboolean

True if this is the default topic for the specified resource. There should only be 1 topic with this field set per resource. Must be provided while creating a topic only.

titlestring
topicIdstring

Short friendly form of a topic id that uniquely identifies the topic within a resource.

topicSlugstring

Short friendly form of a topic title.

topicUuidstring uuid

Unique id of the topic generated while create new one. Returned for reference but must be provided through URL only.

visibility'DISCOVERABLE' | 'OPEN' | 'PRIVATE'

Topic visibility. The field is required.

Changes

No recorded changes to this operation across all 2 revisions of this API.