excludeFromSearch: true

# Create new topic

This request creates a new resource. Use API to {achieve goal}.

## HTTP request

```
POST https://api.example.com/resource-name?param1="value"
```

### Parameters

| Parameter | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `param1` |  | string | Optional | - |


## Request headers

| Header | Description | Type | Required | Notes |
|  --- | --- | --- | --- | --- |
| `Authorization` | [Your Base-64 encoded username and password.](/connectivity/docs/authentication) | string | Required | - |


## Request body

```json
{
  "id": "1",
  "parent": [
    {
      "child": {
        "foo": "bar"
      }
    },
    {
      "child": {
        "foo": "bar"
      }
    }
  ]
}
```

| Field | Description | Type | Min/max | Notes |
|  --- | --- | --- | --- | --- |
| `id` |  | int | 1..1 | - |
| `parent` |  | array | 1..1 | - |
| `parent.child` |  | object | 0..* | - |
| `parent.child.foo` |  | string | 1..1 | - |


## Response headers

| Header | Description | Type | Notes |
|  --- | --- | --- | --- |
| `RUID` | Response Unique IDentifier. | string | - |


## Response body

```json
{
  "parent": [
    {
      "child": {
        "foo": "bar"
      }
    },
    {
      "child": {
        "foo": "bar"
      }
    }
  ]
}
```

| Field | Description | Type | Min/max | Notes |
|  --- | --- | --- | --- | --- |
| `parent` |  | array | 0..1 | - |
| `parent.child` |  | object | 0..* | - |
| `parent.child.foo` |  | string | 1..1 | - |


## Response codes

| Code | Description | Notes |
|  --- | --- | --- |
| `404` | Resource not found. | - |
|  |  |  |