# Retrieve the configuration at the specified path parameter

`GET /devops/config`

It is recommended to not omit the query parameter path.
Otherwise, the full configurations of all services are aggregated in the response, which can become megabytes big.

Authentication (security requirement alternatives):

```json
[
  {
    "DevOpsBasic": []
  },
  {
    "DevOpsBearer": []
  }
]
```

- DevOpsBasic: http (basic). Eclipse Ditto devops user (devops) + password (foobar)
- DevOpsBearer: http (bearer). A JSON Web Token issued by a supported OAuth 2.0 Identity Provider for the Eclipse Ditto devops user.

Parameters:

- `path` (query, string, optional) - The path points to information on service name, service instance index, JVM arguments and environment variables.
  Type: string
  
  Example:
  
  ```json
  "ditto.info"
  ```

Responses:

- 200: Return the configuration at the path

Content type: application/json

Type: RetrieveConfig

Schema: [RetrieveConfig](https://sourcey-ditto.pages.dev/http-api-doc/models/retrieveconfig.md)

- `gateway` (optional)
  Type: object
  
  Module
  
  - `pod` (optional)
    Type: object
    
    Return the configuration at the path ditto.info
    
    - `type` (optional)
      Type: string
      
      devops.responses:ResultConfig
    
    - `status` (optional)
      Type: integer
      
      The HTTP status
    
    - `config` (optional)
      Type: object
      
      name of service
      
      - `env` (optional)
        Type: any
        
        - `PATH` (optional)
          Type: string
        
        Items:
          Type: string
      
      - `service` (optional)
        Type: any
        
        - `instance-index` (optional)
          Type: integer
        
        - `service-name` (optional)
          Type: string
        
        Items:
          Type: string
      
      - `vm-args` (optional)
        Type: any
        
        Items:
          Type: string

- 401: The request could not be completed due to missing authentication.

Content type: text/plain

Type: TextUnauthorizeError

Schema: [TextUnauthorizeError](https://sourcey-ditto.pages.dev/http-api-doc/models/textunauthorizeerror.md)

Example:

```json
"The supplied authentication is invalid"
```

## Examples

### cURL

```bash
curl -X GET 'https://ditto.eclipseprojects.io/devops/config' \
  -H 'Authorization: Basic WU9VUl9VU0VSTkFNRTpZT1VSX1BBU1NXT1JE'
```

### JavaScript

```javascript
const response = await fetch('https://ditto.eclipseprojects.io/devops/config', {
  method: 'GET',
  headers: {
    'Authorization': 'Basic WU9VUl9VU0VSTkFNRTpZT1VSX1BBU1NXT1JE',
  },
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get(
    'https://ditto.eclipseprojects.io/devops/config',
    headers={
        'Authorization': 'Basic WU9VUl9VU0VSTkFNRTpZT1VSX1BBU1NXT1JE',
    },
)
print(response.text)
```