Comments

Comments

GET

/comments

Returns comments for a task identified by its id

Prod:
https://api.seic.com/v1/workdesk/comments
Query Parameters
Name Description Data Type Required
key

The jira ticket number.

string

Header Parameters
Name Description Data Type Required
Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

string

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

string

HTTP Responses
  • Code
    Description
  • 200

    OK- The request has succeeded and the response has been returned.

  • 400

    Bad request - The server cannot or will not process the request due to something that is perceived to be an error on the client application side.

  • 401

    Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.

  • 500

    Internal Server Error - The server was unable to fulfill the request due to an unknown condition.

TEST ENDPOINT
key

The jira ticket number.

Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

Request Body

HTTP Basic

OAuth 2.0

API Key

Working...

Comments

Comments

GET

/comments

Returns comments for a task identified by its id

Prod:
https://api.seic.com/v1/workdesk/comments
Query Parameters
Name Description Data Type Required
key

The jira ticket number.

string

Header Parameters
Name Description Data Type Required
Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

string

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

string

HTTP Responses
  • Code
    Description
  • 200

    OK- The request has succeeded and the response has been returned.

  • 400

    Bad request - The server cannot or will not process the request due to something that is perceived to be an error on the client application side.

  • 401

    Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.

  • 500

    Internal Server Error - The server was unable to fulfill the request due to an unknown condition.

TEST ENDPOINT
key

The jira ticket number.

Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

Request Body

HTTP Basic

OAuth 2.0

API Key

Working...

Test: https://test.api.seic.com/v1/workdesk/comments
TLS*: https://mtls.api.seic.com/v1/workdesk/comments
*The TLS endpoint is only used if Server Based Application was selected during the App Registration process.

Pass the oAuth Token and the App key to invoke this endpoint for a particular application.

This endpoint returns the list of all comments for a given ticket.The value for the field "key" obtained from the "workdesk/ticketinfo" endpoint response serves as an input value for the key query param in this endpoint.

Comments

Comments

GET

/comments

Returns comments for a task identified by its id

Prod:
https://api.seic.com/v1/workdesk/comments
Query Parameters
Name Description Data Type Required
key

The jira ticket number.

string

Header Parameters
Name Description Data Type Required
Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

string

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

string

HTTP Responses
  • Code
    Description
  • 200

    OK- The request has succeeded and the response has been returned.

  • 400

    Bad request - The server cannot or will not process the request due to something that is perceived to be an error on the client application side.

  • 401

    Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.

  • 500

    Internal Server Error - The server was unable to fulfill the request due to an unknown condition.

TEST ENDPOINT
key

The jira ticket number.

Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

Request Body

HTTP Basic

OAuth 2.0

API Key

Working...

SAMPLE REQUEST

curl -X GET \

 https://api.seic.com/v1/workdesk/comments?key=SB-415 \

  -H 'appkey: gsedgaerhDSHGRSH' \

  -H 'authorization: Bearer ADsgdnnkjnfdIKJN' \


REQUEST HEADER

Authorization: Bearer ADsgdnnkjnfdIKJN
AppKey: gsedgaerhDSHGRSH
RESPONSE HEADER


Content-Type: application/json 
Status: 200 OK 
requesttrackingid: 67e1ff68-164f-03ad-0f2d-5cbbfda56ec9



SAMPLE RESPONSE

{
    "StartAt": 0,
    "MaxResults": 123456,
    "Total": 1,
    "Data": [
        {
            "Id": "111111",
            "CreatedUserName": "Testoff",
            "CreatedBy": "Testing Off",
            "CreatedEmailId": "testoff@seic.com",
            "UpdatedBy": "Testing Off",
            "UpdatedEmailId": "testoff@seic.com",
            "Value": "AP-1234",
            "RenderBody": "AP-1234",
            "CreatedDate": "2018-05-30T15:49:14.847-0400",
            "UpdatedDate": "2018-05-30T15:49:14.847-0400",
            "ErrorMessage": null
        }
    ]
}
MODEL
Operations
Name Description Data Type (L)
Id

Project Id.

string
Value

The value within the Task object.

string
Data

The collection of statistics associated with the Task.

string
UpdatedBy

Name of person who modified comment or attachment of the task.

string
UpdatedEmail

Email address of the person who modified the comment or attachment in the task.

string
UpdatedDate

Date on which comment or attachment was modified in the task.

string
startAt

Starting record count.

string
MaxResults

The maximum number of results that can be returned in the API call.

string
total

The total number of results returned.

string
CreatedUserName

Name of the person who created the comment or uploaded the attachment.

string
CreatedBy

The initial userid that created the folder.

string
CreatedEmailId

Email address of the person who created the comment or uploaded the attachment.

string
RenderBody

The comment text.

string
CreatedDate

Date on which the attachment or comment was added to Jira.

string
ErrorMessage

Descriptive text in a response to further explain the http response code.

string


Comments

Comments

GET

/comments

Returns comments for a task identified by its id

Prod:
https://api.seic.com/v1/workdesk/comments
Query Parameters
Name Description Data Type Required
key

The jira ticket number.

string

Header Parameters
Name Description Data Type Required
Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

string

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

string

HTTP Responses
  • Code
    Description
  • 200

    OK- The request has succeeded and the response has been returned.

  • 400

    Bad request - The server cannot or will not process the request due to something that is perceived to be an error on the client application side.

  • 401

    Unauthorized - Invalid authentication details have been provided. Also useful to trigger an authorization pop up if the API is used from a browser.

  • 500

    Internal Server Error - The server was unable to fulfill the request due to an unknown condition.

TEST ENDPOINT
key

The jira ticket number.

Authorization

The access_token value obtained from the Token endpoint. This is passed as "Bearer access_token".

AppKey

This is the Consumer Key provided during the App Registration process and is used to identify the user. It is a form of user credential generated and provisioned by the SEI Developer Portal for applications associated with individual developers.

Request Body

HTTP Basic

OAuth 2.0

API Key

Working...