# Diggers

## POST diggers

The request creates new digger.

Reference information about the resource:

|     |     |
| --- | --- |
| **API Endpoint** | https://www.diggernaut.com/api/diggers/ |
| **Request Format** | JSON |
| **Response Format** | JSON |
| **Access Level** | User |
| **Limits** | Yes |

Request parameters:

|     |     |
| --- | --- |
| **name** | Digger name \[string\]. |
| **project** | Project ID \[integer\]. Project where digger should be placed to. |
| **url** | URL of source site \[string\]. |
| **status** | Digger status \[string\], can be one of two values: "debug" or "active". Optional. |
| **schedule_from** | Schedule runs starting from this date \[datetime in ISO format\]. Optional. |
| **schedule_to** | Schedule runs ending at this date \[datetime in ISO format\]. Optional. |

- [Example of request with CURL](/content/dev/api-diggers-post-diggers.html#request/index.html)
- [Response](/content/dev/api-diggers-post-diggers.html#response/index.html)

```http
curl -v -X POST -H "Content-type: application/json" -H "Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b" https://www.diggernaut.com/api/diggers/ -d '{"name":"CoolRobot","url":"www.smarty-digger.coolrobot","project":"1"}'
```

```http
HTTP/1.0 201 Created
Date: Fri, 19 Aug 2016 18:02:37 GMT
Content-Language: en
Vary: Accept, Accept-Language, Cookie
Allow: GET, POST, HEAD, OPTIONS
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
{
    "id": 77,
    "name": "CoolRobot",
    "project": 1,
    "url": "www.smarty-digger.coolrobot",
    "status": "debug",
    "schedule_from": null,
    "schedule_to": null,
    "bandwidth": "0.00",
    "calls": 0,
    "requests": 0,
    "last_session": null
}
```