Gamma API

Comment on an issue

POST
/api/projects/{projectId}/issues/{issueId}/comments

Posts a comment as the caller, with the files uploaded for it, and records it in the issue's history. It needs text or a file. Everyone it mentions who is on the project and may read the issue is notified, in the notification panel and by email on the project's schedule for issue.mentioned. 409 on a deleted issue.

Who may call it: Anyone on the project whose permission profile allows issue.create. API keys: yes, given issue.create for this project.

Authorization

cookiegamma.session_token<token>

The session cookie a sign-in sets. Over HTTPS its name carries the __Secure- prefix. Browsers send it on their own; other clients keep it from the sign-in response.

Path Parameters

projectId*string

The project's id.

issueId*string

Request Body

application/json
  1. body
text?string

Plain text; mention someone on the project as <@userId>. Trimmed.

Lengthlength <= 10000
Default""
attachments?array<>

Files uploaded for it beforehand, at most 10.

Itemsitems <= 10
Default[]

Response Body

Created.

application/json
  1. response
comment*
Example Request
curl -X POST 'http://localhost:3000/api/projects/string/issues/string/comments' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "comment": {    "id": "string",    "issueId": "string",    "authorId": "string",    "author": {      "id": "string",      "name": "string",      "image": "string"    },    "importedAuthor": "string",    "text": "string",    "mentions": [      {        "id": "string",        "name": "string"      }    ],    "createdAt": "2019-08-24T14:15:22Z",    "editedAt": "2019-08-24T14:15:22Z",    "attachments": [      {        "id": "string",        "ownerType": "form",        "ownerId": "string",        "ownerField": "string",        "fileName": "string",        "contentType": "string",        "sizeBytes": -9007199254740991,        "createdById": "string",        "createdAt": "2019-08-24T14:15:22Z"      }    ]  }}