# team-discussion

From **GitHub v3 REST API**.

A team discussion is a persistent record of a free-form conversation within a team.

- Type: `object`

## Properties

### `author`

- Required: true
- Type: `object`
- Nullable: true

Simple User

### `body`

- Required: true
- Type: `string`
- Example: `Please suggest improvements to our workflow in comments.`

The main text of the discussion.

### `body_html`

- Required: true
- Type: `string`
- Example: `<p>Hi! This is an area for us to collaborate as a team</p>`

### `body_version`

- Required: true
- Type: `string`
- Example: `0307116bbf7ced493b8d8a346c650b71`

The current version of the body content. If provided, this update operation will be rejected if the given version does not match the latest version on the server.

### `comments_count`

- Required: true
- Type: `integer`
- Example: `0`

### `comments_url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://api.github.com/organizations/1/team/2343027/discussions/1/comments`

### `created_at`

- Required: true
- Type: `string`
- Format: `date-time`
- Example: `2018-01-25T18:56:31Z`

### `html_url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://github.com/orgs/github/teams/justice-league/discussions/1`

### `last_edited_at`

- Required: true
- Type: `string`
- Format: `date-time`
- Nullable: true

### `node_id`

- Required: true
- Type: `string`
- Example: `MDE0OlRlYW1EaXNjdXNzaW9uMQ==`

### `number`

- Required: true
- Type: `integer`
- Example: `42`

The unique sequence number of a team discussion.

### `pinned`

- Required: true
- Type: `boolean`
- Example: `true`

Whether or not this discussion should be pinned for easy retrieval.

### `private`

- Required: true
- Type: `boolean`
- Example: `true`

Whether or not this discussion should be restricted to team members and organization administrators.

### `reactions`

- Required: false
- Type: `object`

### `team_url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://api.github.com/organizations/1/team/2343027`

### `title`

- Required: true
- Type: `string`
- Example: `How can we improve our workflow?`

The title of the discussion.

### `updated_at`

- Required: true
- Type: `string`
- Format: `date-time`
- Example: `2018-01-25T18:56:31Z`

### `url`

- Required: true
- Type: `string`
- Format: `uri`
- Example: `https://api.github.com/organizations/1/team/2343027/discussions/1`

## JSON Schema

```json
{"description":"A team discussion is a persistent record of a free-form conversation within a team.","properties":{"author":{"$ref":"#/components/schemas/nullable-simple-user"},"body":{"description":"The main text of the discussion.","example":"Please suggest improvements to our workflow in comments.","type":"string"},"body_html":{"example":"\u003cp\u003eHi! This is an area for us to collaborate as a team\u003c/p\u003e","type":"string"},"body_version":{"description":"The current version of the body content. If provided, this update operation will be rejected if the given version does not match the latest version on the server.","example":"0307116bbf7ced493b8d8a346c650b71","type":"string"},"comments_count":{"example":0,"type":"integer"},"comments_url":{"example":"https://api.github.com/organizations/1/team/2343027/discussions/1/comments","format":"uri","type":"string"},"created_at":{"example":"2018-01-25T18:56:31Z","format":"date-time","type":"string"},"html_url":{"example":"https://github.com/orgs/github/teams/justice-league/discussions/1","format":"uri","type":"string"},"last_edited_at":{"format":"date-time","nullable":true,"type":"string"},"node_id":{"example":"MDE0OlRlYW1EaXNjdXNzaW9uMQ==","type":"string"},"number":{"description":"The unique sequence number of a team discussion.","example":42,"type":"integer"},"pinned":{"description":"Whether or not this discussion should be pinned for easy retrieval.","example":true,"type":"boolean"},"private":{"description":"Whether or not this discussion should be restricted to team members and organization administrators.","example":true,"type":"boolean"},"reactions":{"$ref":"#/components/schemas/reaction-rollup"},"team_url":{"example":"https://api.github.com/organizations/1/team/2343027","format":"uri","type":"string"},"title":{"description":"The title of the discussion.","example":"How can we improve our workflow?","type":"string"},"updated_at":{"example":"2018-01-25T18:56:31Z","format":"date-time","type":"string"},"url":{"example":"https://api.github.com/organizations/1/team/2343027/discussions/1","format":"uri","type":"string"}},"required":["author","body","body_html","body_version","comments_count","comments_url","created_at","last_edited_at","html_url","pinned","private","node_id","number","team_url","title","updated_at","url"],"title":"Team Discussion","type":"object"}
```