---
title: "Join authenticated User to Topic with a given token."
method: POST
path: "/api/topics/join/:token"
tags: ["topic"]
---

# Join authenticated User to Topic with a given token.

`POST /api/topics/join/:token`

Allows sharing of private join urls for example in forums, on conference screen...

## Path parameters

- `token` string, required

## Response `200`

returns topic that user has joined

- object
  - `status` object
    - `code` integer
  - `data` object
    - `id` string, uuid
    - `title` string, nullable
    - `description` string, html
    - `status` 'inProgress' | 'voting' | 'followUp' | 'closed'
    - `visibility` 'public' | 'private'
    - `categories` string[]
    - `sourcePartnerId` string, uuid
    - `sourcePartnerObjectId` string
    - `creator` object
      - `id` string, uuid
      - `name` string
    - `padUrl` string
    - `url` string — link to topic
    - `endsAt` string
    - `hashtag` string
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `400` — Matching token not found

## Changes

> 10 revisions in range; 1 could not be searched.

- **2021-10-08** `dc70d883acda` — 1 info
  - endpoint added
- **2018-08-20** `ba36cd387928` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/citizenos/apis/citizenos-api/changes/api/topics/join/:token/post.md)

---

[API](https://skmtc.dev/citizenos/apis/citizenos-api.md) · [All operations](https://skmtc.dev/citizenos/apis/citizenos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citizenos/citizenos-api/revisions/ca28908e6b75/schema)