Topics

Create a new topic (or return existing on case-insensitive name match)

Adds a new topic to the global catalog. The topics.name column is case-insensitive (citext) and unique — if a topic with the given name already exists (any case), the existing row is returned with HTTP 200 and meta.created = false so the client can show a "Topic already exists — selected" toast (MED-832 AC7).

Newly created topics return HTTP 201 with meta.created = true. The new topic is is_active = true and gets display_order = MAX + 1.

post/topics

Request

  • Base URL
    https://api.production.yourmedley.com
  • Auth
    HTTP bearer

Request body

namestring required

Topic name. Whitespace is trimmed. Empty string is rejected.

Example request

{
  "name": "Group Formation"
}

Response

Existing topic returned (case-insensitive name match)

successboolean

Example response

{
  "data": {
    "name": "Active Listening"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.