2014-04-16 00:53:12 +00:00
|
|
|
|
page_title: docker.io Accounts API
|
|
|
|
|
page_description: API Documentation for docker.io accounts.
|
|
|
|
|
page_keywords: API, Docker, accounts, REST, documentation
|
|
|
|
|
|
|
|
|
|
# docker.io Accounts API
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
## Get a single user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
|
`GET /api/v1.1/users/:username/`
|
|
|
|
|
|
|
|
|
|
Get profile info for the specified user.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **username** – username of the user whose profile info is being
|
2014-04-16 00:53:12 +00:00
|
|
|
|
requested.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Request Headers:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Authorization** – required authentication credentials of
|
2014-04-16 00:53:12 +00:00
|
|
|
|
either type HTTP Basic or OAuth Bearer Token.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Status Codes:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **200** – success, user data returned.
|
|
|
|
|
- **401** – authentication error.
|
|
|
|
|
- **403** – permission error, authenticated user must be the user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
whose data is being requested, OAuth access tokens must have
|
|
|
|
|
`profile_read` scope.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **404** – the specified username does not exist.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example request**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
GET /api/v1.1/users/janedoe/ HTTP/1.1
|
|
|
|
|
Host: www.docker.io
|
|
|
|
|
Accept: application/json
|
|
|
|
|
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example response**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
HTTP/1.1 200 OK
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"id": 2,
|
|
|
|
|
"username": "janedoe",
|
|
|
|
|
"url": "https://www.docker.io/api/v1.1/users/janedoe/",
|
|
|
|
|
"date_joined": "2014-02-12T17:58:01.431312Z",
|
|
|
|
|
"type": "User",
|
|
|
|
|
"full_name": "Jane Doe",
|
|
|
|
|
"location": "San Francisco, CA",
|
|
|
|
|
"company": "Success, Inc.",
|
|
|
|
|
"profile_url": "https://docker.io/",
|
|
|
|
|
"gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
|
|
|
|
|
"email": "jane.doe@example.com",
|
|
|
|
|
"is_active": true
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
## Update a single user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
|
`PATCH /api/v1.1/users/:username/`
|
|
|
|
|
|
|
|
|
|
Update profile info for the specified user.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **username** – username of the user whose profile info is being
|
2014-04-16 00:53:12 +00:00
|
|
|
|
updated.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Json Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **full_name** (*string*) – (optional) the new name of the user.
|
|
|
|
|
- **location** (*string*) – (optional) the new location.
|
|
|
|
|
- **company** (*string*) – (optional) the new company of the user.
|
|
|
|
|
- **profile_url** (*string*) – (optional) the new profile url.
|
|
|
|
|
- **gravatar_email** (*string*) – (optional) the new Gravatar
|
2014-04-16 00:53:12 +00:00
|
|
|
|
email address.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Request Headers:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Authorization** – required authentication credentials of
|
2014-04-16 00:53:12 +00:00
|
|
|
|
either type HTTP Basic or OAuth Bearer Token.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Content-Type** – MIME Type of post data. JSON, url-encoded
|
2014-04-16 00:53:12 +00:00
|
|
|
|
form data, etc.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Status Codes:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **200** – success, user data updated.
|
|
|
|
|
- **400** – post data validation error.
|
|
|
|
|
- **401** – authentication error.
|
|
|
|
|
- **403** – permission error, authenticated user must be the user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
whose data is being updated, OAuth access tokens must have
|
|
|
|
|
`profile_write` scope.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **404** – the specified username does not exist.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example request**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
PATCH /api/v1.1/users/janedoe/ HTTP/1.1
|
|
|
|
|
Host: www.docker.io
|
|
|
|
|
Accept: application/json
|
|
|
|
|
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"location": "Private Island",
|
|
|
|
|
"profile_url": "http://janedoe.com/",
|
|
|
|
|
"company": "Retired",
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example response**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
HTTP/1.1 200 OK
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"id": 2,
|
|
|
|
|
"username": "janedoe",
|
|
|
|
|
"url": "https://www.docker.io/api/v1.1/users/janedoe/",
|
|
|
|
|
"date_joined": "2014-02-12T17:58:01.431312Z",
|
|
|
|
|
"type": "User",
|
|
|
|
|
"full_name": "Jane Doe",
|
|
|
|
|
"location": "Private Island",
|
|
|
|
|
"company": "Retired",
|
|
|
|
|
"profile_url": "http://janedoe.com/",
|
|
|
|
|
"gravatar_url": "https://secure.gravatar.com/avatar/0212b397124be4acd4e7dea9aa357.jpg?s=80&r=g&d=mm"
|
|
|
|
|
"email": "jane.doe@example.com",
|
|
|
|
|
"is_active": true
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
## List email addresses for a user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
|
`GET /api/v1.1/users/:username/emails/`
|
|
|
|
|
|
|
|
|
|
List email info for the specified user.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **username** – username of the user whose profile info is being
|
2014-04-16 00:53:12 +00:00
|
|
|
|
updated.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Request Headers:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Authorization** – required authentication credentials of
|
2014-04-16 00:53:12 +00:00
|
|
|
|
either type HTTP Basic or OAuth Bearer Token
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Status Codes:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **200** – success, user data updated.
|
|
|
|
|
- **401** – authentication error.
|
|
|
|
|
- **403** – permission error, authenticated user must be the user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
whose data is being requested, OAuth access tokens must have
|
|
|
|
|
`email_read` scope.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **404** – the specified username does not exist.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example request**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
GET /api/v1.1/users/janedoe/emails/ HTTP/1.1
|
|
|
|
|
Host: www.docker.io
|
|
|
|
|
Accept: application/json
|
|
|
|
|
Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example response**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
HTTP/1.1 200 OK
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
|
|
|
|
|
[
|
|
|
|
|
{
|
|
|
|
|
"email": "jane.doe@example.com",
|
|
|
|
|
"verified": true,
|
|
|
|
|
"primary": true
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
## Add email address for a user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
|
`POST /api/v1.1/users/:username/emails/`
|
|
|
|
|
|
|
|
|
|
Add a new email address to the specified user's account. The email
|
|
|
|
|
address must be verified separately, a confirmation email is not
|
|
|
|
|
automatically sent.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Json Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **email** (*string*) – email address to be added.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Request Headers:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Authorization** – required authentication credentials of
|
2014-04-16 00:53:12 +00:00
|
|
|
|
either type HTTP Basic or OAuth Bearer Token.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Content-Type** – MIME Type of post data. JSON, url-encoded
|
2014-04-16 00:53:12 +00:00
|
|
|
|
form data, etc.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Status Codes:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **201** – success, new email added.
|
|
|
|
|
- **400** – data validation error.
|
|
|
|
|
- **401** – authentication error.
|
|
|
|
|
- **403** – permission error, authenticated user must be the user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
whose data is being requested, OAuth access tokens must have
|
|
|
|
|
`email_write` scope.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **404** – the specified username does not exist.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example request**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
POST /api/v1.1/users/janedoe/emails/ HTTP/1.1
|
|
|
|
|
Host: www.docker.io
|
|
|
|
|
Accept: application/json
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"email": "jane.doe+other@example.com"
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example response**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
HTTP/1.1 201 Created
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"email": "jane.doe+other@example.com",
|
|
|
|
|
"verified": false,
|
|
|
|
|
"primary": false
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
## Delete email address for a user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
|
`DELETE /api/v1.1/users/:username/emails/`
|
|
|
|
|
|
|
|
|
|
Delete an email address from the specified user's account. You
|
|
|
|
|
cannot delete a user's primary email address.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Json Parameters:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **email** (*string*) – email address to be deleted.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Request Headers:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Authorization** – required authentication credentials of
|
2014-04-16 00:53:12 +00:00
|
|
|
|
either type HTTP Basic or OAuth Bearer Token.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **Content-Type** – MIME Type of post data. JSON, url-encoded
|
2014-04-16 00:53:12 +00:00
|
|
|
|
form data, etc.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
Status Codes:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **204** – success, email address removed.
|
|
|
|
|
- **400** – validation error.
|
|
|
|
|
- **401** – authentication error.
|
|
|
|
|
- **403** – permission error, authenticated user must be the user
|
2014-04-16 00:53:12 +00:00
|
|
|
|
whose data is being requested, OAuth access tokens must have
|
|
|
|
|
`email_write` scope.
|
2014-09-09 05:00:23 +00:00
|
|
|
|
- **404** – the specified username or email address does not
|
2014-04-16 00:53:12 +00:00
|
|
|
|
exist.
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example request**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
DELETE /api/v1.1/users/janedoe/emails/ HTTP/1.1
|
|
|
|
|
Host: www.docker.io
|
|
|
|
|
Accept: application/json
|
|
|
|
|
Content-Type: application/json
|
|
|
|
|
Authorization: Bearer zAy0BxC1wDv2EuF3tGs4HrI6qJp6KoL7nM
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"email": "jane.doe+other@example.com"
|
|
|
|
|
}
|
|
|
|
|
|
2014-09-09 05:00:23 +00:00
|
|
|
|
**Example response**:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
HTTP/1.1 204 NO CONTENT
|
|
|
|
|
Content-Length: 0
|