CRcrowdin
Discussions

Add Project Discussion

Required scopes: project.discussion (Read and Write).

Starts a new project discussion with a description. Every project member is notified about the new discussion, and the users mentioned in the description are notified about the mention.

Note: Only project members can start discussions

post/projects/{projectId}/discussions

Request

Path parameters

projectIdinteger required

Project Identifier. Get via List Projects

Request body

titlestring required

Discussion title, up to 255 characters

textstring required

Description of the discussion in Markdown, up to 16000 characters, posted as its first reply. Mention a project member with @username to notify them

languageIdstring nullable

ID of the target language the discussion is about. Get via Project Target Languages. null or omitted for a discussion about all languages

Example request

{
  "title": "Tone of voice for the checkout screens",
  "text": "Should we address customers formally on the checkout screens? @olena what do you think?",
  "languageId": "uk"
}

Response

Discussion created

Example response

{
  "data": {
    "id": 55,
    "projectId": 1,
    "title": "Tone of voice for the checkout screens",
    "status": "open",
    "languageId": "uk",
    "userId": 31,
    "user": {
      "id": 31,
      "username": "olena",
      "fullName": "Olena Koval",
      "avatarUrl": "https://crowdin-static.downloads.crowdin.com/avatar/13240049/medium/5cf4d2e1b0b9b6b7e8e1a2b9f7c0d0c1.png"
    },
    "repliesCount": 4,
    "createdAt": "2026-09-20T11:11:05+00:00",
    "updatedAt": "2026-09-21T09:30:00+00:00"
  }
}

Changes

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