GET /help/endpoints/{endpoint_id}

Retrieves a single endpoint documentation object.

Retrieves a single endpoint documentation object.

Table 1. GET /help/endpoints/{endpoint_id} resource details
MIME Type

application/json

Table 2. GET /help/endpoints/{endpoint_id} request parameter details
Parameter Type Optionality Data Type MIME Type Description

endpoint_id

path

Required

Number (Integer)

text/plain

The endpoint id.

fields

query

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. GET /help/endpoints/{endpoint_id} response codes
HTTP Response Code Unique Code Description

200

The endpoint documentation object was retrieved.

404

1002

No endpoint documentation object was found for the provided endpoint id.

500

1020

An unexpected error has occurred.

Response Description

An endpoint documentation object. An endpoint documentation object contains the following fields:
  • id - Number - The ID of the endpoint documentation. This ID is not permanent. It might change any time services are restarted.
  • summary - String - A brief summary of the endpoint.
  • deprecated - Boolean - Returns true if the endpoint is deprecated. Returns false otherwise.
  • http_method - String - The HTTP request type. One of OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT, PATCH.
  • error_responses - Array of Objects - A list of potential error responses of this endpoint.
  • error_responses(response_code) - Number - The HTTP code for this error response.
  • error_responses(description) - String - The description for this error response.
  • error_responses(unique_code) - Number - The unique code for this error response.
  • error_responses(response_code_description) - String - The description of the response.
  • response_description - String - The description of the response.
  • version - String - The version of this endpoint.
  • success_responses - Array of Objects - A list of potential success responses for this endpoint.
  • success_responses(response_code) - Number - The HTTP code for this response.
  • success_responses(description) - String - The description of this response.
  • success_responses(response_code_description) - String - The name for the response code from RFC 2616.
  • description - String - A description of this endpoint.
  • path - String - The path of this endpoint.
  • response_mime_types - Array of Objects - A list of possible response MIME types for this endpoint.
  • response_mime_types(mime_type) - String - The MIME type value, e.g. TEXT_PLAIN
  • response_mime_types(media_type) - String - The RFC style Media Type, e.g. text/plain This value is suitable for use in HTTP requests.
  • response_mime_types(sample) - String - The sample of this response MIME type.
  • parameters - Array of Objects - A list of user parameters for this endpoint.
  • parameters(description) - String - A description of this parameter.
  • parameters(default_value) - String - The default value of this parameter. Null if there is no default value for this parameter. This is always a String, regardless of the underlying data type of the parameter.
  • parameters(type) - String - The type of parameter, one of QUERY, HEADER, PATH, BODY.
  • parameters(parameter_name) - String - The name of this parameter.
  • parameters(mime_types) - Array of Objects - A list of possible mime_types for this parameter.
  • parameters(mime_types(data_type)) - String - A description of the data type of this parameter.
  • parameters(mime_types(mime_type)) - String - The MIME type of the parameter.
  • parameters(mime_types(sample)) - String - The sample for this parameter.
  • resource_id - Number - The ID of the associated resource.
  • last_modified_version - String - The API version this endpoint was last modified. It will be less than or equal to the version in the version field.
  • caller_has_access - Boolean - Returns true if the user has the required capabilities to call this endpoint. Returns false otherwise.

Response Sample


{
  "caller_has_access": true,
  "deprecated": true,
  "description": "String",
  "error_responses": [
    {
      "description": "String",
      "response_code": 42,
      "response_code_description": "String",
      "unique_code": 42
    }
  ],
  "http_method": "String <one of: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT, PATCH>",
  "id": 42,
  "last_modified_version": "String",
  "parameters": [
    {
      "default_value": "String",
      "description": "String",
      "mime_types": [
        {
          "data_type": "String",
          "mime_type": "String",
          "sample": "String"
        }
      ],
      "parameter_name": "String",
      "type": "String <one of: QUERY, HEADER, PATH, BODY>"
    }
  ],
  "path": "String",
  "resource_id": 42,
  "response_description": "String",
  "response_mime_types": [
    {
      "mime_type": "String",
      "sample": "String"
    }
  ],
  "success_responses": [
    {
      "description": "String",
      "response_code": 42,
      "response_code_description": "String"
    }
  ],
  "summary": "String",
  "version": "String"
}