Update a comment on a snippet

PUT

/snippets/{workspace}/{encoded_id}/comments/{comment_id}

Updates a comment.

The only required field in the body is content.raw.

Comments can only be updated by their author.

Authorizations

• oauth2
  snippet
• basic
• api_key

Parameters

Path Parameters

comment_id

required

integer format: int64

The id of the comment.

encoded_id

required

string

The snippet id.

workspace

required

string

This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example: {workspace UUID}.

Request Body ^required

The contents to update the comment to.

Media type application/json

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

snippet

object

type

required

string

id

integer

title

string

scm

The DVCS used to store the snippet.

string

Allowed values: git

created_on

string format: date-time

updated_on

string format: date-time

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

creator

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

is_private

boolean

Responses

200

The updated comment object.

Media type application/json

object

type

required

string

links

object

self

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

html

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

snippet

object

type

required

string

id

integer

title

string

scm

The DVCS used to store the snippet.

string

Allowed values: git

created_on

string format: date-time

updated_on

string format: date-time

owner

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

creator

object

type

required

string

links

Account Links

Links related to an Account.

object

avatar

Link

A link to a resource related to this object.

object

href

string format: uri

name

string

key

additional properties

any

created_on

string format: date-time

display_name

string

uuid

string

is_private

boolean

Example

{
  "snippet": {
    "scm": "git"
  }
}

403

If the authenticated user does not have access to the snippet.

Media type application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}

404

If the comment or snippet does not exist.

Media type application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}