# API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

## Resource types

1. [Timeline](https://developers.google.com/glass/v1/reference#Timeline)
2. [Timeline.attachments](https://developers.google.com/glass/v1/reference#Timeline.attachments)
3. [Subscriptions](https://developers.google.com/glass/v1/reference#Subscriptions)
4. [Locations](https://developers.google.com/glass/v1/reference#Locations)
5. [Contacts](https://developers.google.com/glass/v1/reference#Contacts)
6. [Accounts](https://developers.google.com/glass/v1/reference#Accounts)
7. [Settings](https://developers.google.com/glass/v1/reference#Settings)

## Timeline

For Timeline Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/timeline#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [delete](https://developers.google.com/glass/v1/reference/timeline/delete) | `DELETE /timeline/id` | Deletes a timeline item. |
| [get](https://developers.google.com/glass/v1/reference/timeline/get) | `GET /timeline/id` | Gets a single timeline item by ID. |
| [insert](https://developers.google.com/glass/v1/reference/timeline/insert) | `POST https://www.googleapis.com/upload/mirror/v1/timeline` and `POST /timeline` | Inserts a new item into the timeline. |
| [list](https://developers.google.com/glass/v1/reference/timeline/list) | `GET /timeline` | Retrieves a list of timeline items for the authenticated user. |
| [patch](https://developers.google.com/glass/v1/reference/timeline/patch) | `PATCH /timeline/id` | Updates a timeline item in place. This method supports [patch semantics](https://developers.google.com/glass/performance#patch). |
| [update](https://developers.google.com/glass/v1/reference/timeline/update) | `PUT https://www.googleapis.com/upload/mirror/v1/timeline/id` and `PUT /timeline/id` | Updates a timeline item in place. |

## Timeline.attachments

For Timeline.attachments Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/timeline/attachments#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [delete](https://developers.google.com/glass/v1/reference/timeline/attachments/delete) | `DELETE /timeline/itemId/attachments/attachmentId` | Deletes an attachment from a timeline item. |
| [get](https://developers.google.com/glass/v1/reference/timeline/attachments/get) | `GET /timeline/itemId/attachments/attachmentId` | Retrieves an attachment on a timeline item by item ID and attachment ID. |
| [insert](https://developers.google.com/glass/v1/reference/timeline/attachments/insert) | `POST https://www.googleapis.com/upload/mirror/v1/timeline/itemId/attachments` | Adds a new attachment to a timeline item. |
| [list](https://developers.google.com/glass/v1/reference/timeline/attachments/list) | `GET /timeline/itemId/attachments` | Returns a list of attachments for a timeline item. |

## Subscriptions

For Subscriptions Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/subscriptions#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [delete](https://developers.google.com/glass/v1/reference/subscriptions/delete) | `DELETE /subscriptions/id` | Deletes a subscription. |
| [insert](https://developers.google.com/glass/v1/reference/subscriptions/insert) | `POST /subscriptions` | Creates a new subscription. |
| [list](https://developers.google.com/glass/v1/reference/subscriptions/list) | `GET /subscriptions` | Retrieves a list of subscriptions for the authenticated user and service. |
| [update](https://developers.google.com/glass/v1/reference/subscriptions/update) | `PUT /subscriptions/id` | Updates an existing subscription in place. |

## Locations

For Locations Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/locations#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [get](https://developers.google.com/glass/v1/reference/locations/get) | `GET /locations/id` | Gets a single location by ID. |
| [list](https://developers.google.com/glass/v1/reference/locations/list) | `GET /locations` | Retrieves a list of locations for the user. |

## Contacts

For Contacts Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/contacts#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [delete](https://developers.google.com/glass/v1/reference/contacts/delete) | `DELETE /contacts/id` | Deletes a contact. |
| [get](https://developers.google.com/glass/v1/reference/contacts/get) | `GET /contacts/id` | Gets a single contact by ID. |
| [insert](https://developers.google.com/glass/v1/reference/contacts/insert) | `POST /contacts` | Inserts a new contact. |
| [list](https://developers.google.com/glass/v1/reference/contacts/list) | `GET /contacts` | Retrieves a list of contacts for the authenticated user. |
| [patch](https://developers.google.com/glass/v1/reference/contacts/patch) | `PATCH /contacts/id` | Updates a contact in place. This method supports [patch semantics](https://developers.google.com/glass/performance#patch). |
| [update](https://developers.google.com/glass/v1/reference/contacts/update) | `PUT /contacts/id` | Updates a contact in place. |

## Accounts

For Accounts Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/accounts#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [insert](https://developers.google.com/glass/v1/reference/accounts/insert) | `POST /accounts/userToken/accountType/accountName` | Inserts a new account for a user |

## Settings

For Settings Resource details, see the [resource representation](https://developers.google.com/glass/v1/reference/settings#resource) page.

| Method | HTTP request | Description |
|---|---|---|
| URIs relative to https://www.googleapis.com/mirror/v1, unless otherwise noted |||
| [get](https://developers.google.com/glass/v1/reference/settings/get) | `GET /settings/id` | Gets a single setting by ID. |