Comment API
https://api.gandi.net/v5/comment
Manage your comments on gandi products ¶
https://api.gandi.net/v5/comment/comments/{id}
get Return the comment ¶
Request
URI Parameters
- id ⁠stringThe gandi product entity_id
 
- id ⁠string
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 
- Authorization ⁠string
Responses
200
Body
- application/json⁠object- With the following properties: - content ⁠string
- id ⁠stringThe gandi product entity_id.
 - Optional- created_at ⁠datetime
- updated_at ⁠datetime
- user ⁠objectWith the following properties: - id ⁠stringUUID
- name ⁠string
- sharing_id ⁠stringUUID
 
- id ⁠string
 Example:- { "id": "ae5680b2-8c8f-11eb-8460-00163ec4cb00", "content": "This is a comment.", "created_at": "2021-05-18T11:36:59Z", "updated_at": "2021-05-18T11:36:59Z", "user": { "sharing_id": "3c2f29e4-17be-4db3-b8eb-ec8a3fa96bc0", "id": "3c2f29e4-17be-4db3-b8eb-ec8a3fa96bc0", "name": "alicia" } }
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
401
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
Secured by
Http Authorization Scheme
This authentication scheme allows you to pass your Personal Access Token and be granted access to permissions and resources scoped by this token.
Tokens are created in the Organization Tab of the Gandi Admin application, choose the organization the token will have access too. Then go to the sharing tab, and click on "Create a token" button.
The authentication scheme Apikey allows also you to pass your Gandi API Key, but has been deprecated.
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 
- Authorization ⁠string
post Set the comment for the entity corresponding to the id ¶
Request
URI Parameters
- id ⁠stringThe gandi product entity_id
 
- id ⁠string
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 - Optional- Dry-Run ⁠integerIf this header's value is1the request's parameters will only be checked; the operation will not actually be performed.
 
- Authorization ⁠string
Body
- application/json⁠object- With the following properties: - Required- content ⁠stringThe note content.
 Example:- { "content": "This domain must be renewed." }
- content ⁠string
Responses
200
Dry-Run: 1 header.Headers
- Optional- Warning ⁠stringWarning message
 
- Warning ⁠string
Body
- application/json⁠object- With the following properties: - status ⁠stringOne of: "success", "error" Response status.
 - Optional- errors ⁠arrayA list of all the errors encountered during validation.Of items of type: - objectWith the following properties: - description ⁠stringError message.
- location ⁠stringOne of: "header", "path", "querystring", "body" The field's location in the HTTP response.
- name ⁠stringThe xpath of the field.
 
- description ⁠string
 
- object
 
- status ⁠string
202
Headers
- Optional- Location ⁠string
 
Body
- application/json⁠object- With the following properties: - message ⁠stringConfirmation message.
 
- message ⁠string
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
401
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
Secured by
Http Authorization Scheme
This authentication scheme allows you to pass your Personal Access Token and be granted access to permissions and resources scoped by this token.
Tokens are created in the Organization Tab of the Gandi Admin application, choose the organization the token will have access too. Then go to the sharing tab, and click on "Create a token" button.
The authentication scheme Apikey allows also you to pass your Gandi API Key, but has been deprecated.
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 
- Authorization ⁠string
delete Delete the comment for the entity corresponding to the id. ¶
Request
URI Parameters
- id ⁠stringThe gandi product entity_id
 
- id ⁠string
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 
- Authorization ⁠string
Responses
204
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
401
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
403
Body
- application/json⁠object- With the following properties: - cause ⁠string
- code ⁠integer
- message ⁠string
- object ⁠string
 
Secured by
Http Authorization Scheme
This authentication scheme allows you to pass your Personal Access Token and be granted access to permissions and resources scoped by this token.
Tokens are created in the Organization Tab of the Gandi Admin application, choose the organization the token will have access too. Then go to the sharing tab, and click on "Create a token" button.
The authentication scheme Apikey allows also you to pass your Gandi API Key, but has been deprecated.
Headers
- Required- Authorization ⁠stringTheAuthorizationheader must start withBearerfor access token, orApikeydepending of the authentication scheme.Apikeyis deprecated and be replaced by personal access token.Example:Bearer pat_abc-123Example:Apikey your-api-key
 
- Authorization ⁠string