# Diggers

## PATCH diggers/:id

The request updates only the passed fields for the specified digger.

Reference information about the resource:

|     |     |
| --- | --- |
| **API Endpoint** | https://www.diggernaut.com/api/diggers/:id |
| **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-patch-diggers-id.html#request/index.html)
- [Response](/content/dev/api-diggers-patch-diggers-id.html#response/index.html)

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

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