photo · sneakypete81 · Mar 28, 2013 · Jul 21, 2013
diff --git a/docs/api/GetTags.markdown b/docs/api/GetTags.markdown
@@ -81,23 +81,26 @@ The response is in a standard [response envelope](http://theopenphotoproject.org
         {
           "id": "mountain",
           "count": 1
+          "actor": "jaisen@jmathai.com"
+          "owner": "jaisen@jmathai.com"
         },
         {
           "id": "jaisen",
           "count": 10,
-          "email": "jaisen@jmathai.com"
+          "actor": "jaisen@jmathai.com"
+          "owner": "jaisen@jmathai.com"
         },
         {
           "id": "New York",
           "count": 9,
-          "latitude": 12.3456,
-          "longitude": 78.9012
+          "actor": "jaisen@jmathai.com"
+          "owner": "jaisen@jmathai.com"
         },
         {
           "id": "Sunnyvale",
           "count":23
-          "latitude": 13.579,
-          "longitude": 24.68
+          "actor": "jaisen@jmathai.com"
+          "owner": "jaisen@jmathai.com"
         },
         ....
       ]

diff --git a/docs/api/PostTagCreate.markdown b/docs/api/PostTagCreate.markdown
@@ -18,7 +18,8 @@ Create Tag
 <a name="purpose"></a>
 ### Purpose of the Create Tag API
 
-Use this API to create a tag.
+This API is used internally to create a tag.
+External applications should use the [Photo Update API](http://theopenphotoproject.org/documentation/api/PostPhotoUpdate) to create tags.
 
 ----------------------------------------
 
@@ -34,9 +35,6 @@ _Authentication: required_
 
 1.  tag (required), The name of the tag to create
 1.  count (optional), Number of photos which contain this tag
-1.  email (optional), An email address that corresponds to this tag
-1.  latitude (optional), _i.e. 34.76_ - A decimal representation of latitude.
-1.  longitude (optional), _i.e. -87.45_ - A decimal representation of longitude.
 
 ----------------------------------------
 
@@ -63,19 +61,15 @@ The response is in a standard [response envelope](http://theopenphotoproject.org
 
 * _message_, A string describing the result. Don't use this for anything but reading.
 * _code_, _201_ on success
-* _result_, A [Tag][Tag] object or FALSE on error
+* _result_, TRUE if the tag was successfully created
 
 <a name="sample"></a>
 #### Sample
 
     {
       "message":"",
       "code":201,
-      "result":     	
-      {
-        "id": "mountain",
-        "count": 0
-      }
+      "result":TRUE
     }
 
 

diff --git a/docs/api/PostTagDelete.markdown b/docs/api/PostTagDelete.markdown
@@ -0,0 +1,83 @@
+Delete Tag
+=======================
+
+
+----------------------------------------
+
+1. [Purpose][purpose]
+1. [Endpoint][endpoint]
+1. [Parameters][parameters]
+1. [Examples][examples]
+  * [Command line][example-cli]
+  * [PHP][example-php]
+1. [Response][response]
+  * [Sample][sample]
+
+----------------------------------------
+
+<a name="purpose"></a>
+### Purpose of the Delete Tag API
+
+This API is used internally to delete a tag.
+External applications should use the [Photo Update API](http://theopenphotoproject.org/documentation/api/PostPhotoUpdate) to delete tags.
+
+----------------------------------------
+
+<a name="endpoint"></a>
+### Endpoint
+
+_Authentication: required_
+
+    POST /tag/:id/delete.json
+
+<a name="parameters"></a>
+### Parameters
+
+----------------------------------------
+
+<a name="examples"></a>
+### Examples
+
+<a name="example-cli"></a>
+#### Command Line (using [openphoto-php][openphoto-php])
+
+    ./openphoto -p -X POST -h current.trovebox.com -e /tag/sunnyvale/delete.json
+
+<a name="example-php"></a>
+#### PHP (using [openphoto-php][openphoto-php])
+
+    $client = new OpenPhotoOAuth($host, $consumerKey, $consumerSecret, $oauthToken, $oauthTokenSecret);
+    $response = $client->post("/tag/sunnyvale/delete.json");
+
+----------------------------------------
+
+<a name="response"></a>
+### Response
+
+The response is in a standard [response envelope](http://theopenphotoproject.org/documentation/api/Envelope).
+
+* _message_, A string describing the result. Don't use this for anything but reading.
+* _code_, _201_ on success
+* _result_, TRUE if the tag was successfully deleted
+
+<a name="sample"></a>
+#### Sample
+
+    {
+      "message":"",
+      "code":201,
+      "result":TRUE
+    }
+
+
+[Tag]: http://theopenphotoproject.org/documentation/schemas/Tag
+[purpose]: #purpose
+[endpoint]: #endpoint
+[parameters]: #parameters
+[examples]: #examples
+[example-cli]: #example-cli
+[example-php]: #example-php
+[response]: #response
+[sample]: #sample
+[openphoto-php]: https://github.com/photo/openphoto-php
+
diff --git a/docs/api/PostTagUpdate.markdown b/docs/api/PostTagUpdate.markdown
@@ -7,11 +7,14 @@ Update Tag
 1. [Purpose][purpose]
 1. [Endpoint][endpoint]
 1. [Parameters][parameters]
+<!--- NOTE: These examples are not valid, since there are no tag attributes that can be updated.
+            Leave this commented out until an updateable tag attribute is added.
 1. [Examples][examples]
   * [Command line][example-cli]
   * [PHP][example-php]
 1. [Response][response]
   * [Sample][sample]
+--->
 
 ----------------------------------------
 
@@ -32,22 +35,24 @@ _Authentication: required_
 <a name="parameters"></a>
 ### Parameters
 
-1.  count (optional), Number of photos which contain this tag
-1.  email (optional), An email address that corresponds to this tag
-1.  latitude (optional), _i.e. 34.76_ - A decimal representation of latitude.
-1.  longitude (optional), _i.e. -87.45_ - A decimal representation of longitude.
+There are not currently any tag attributes that can be updated.
 
 ----------------------------------------
 
+<!--- NOTE: These examples are not valid, since there are no tag attributes that can be updated.
+            Leave this commented out until an updateable tag attribute is added.
+
 <a name="examples"></a>
 ### Examples
 
 <a name="example-cli"></a>
+
 #### Command Line (using [openphoto-php][openphoto-php])
 
     ./openphoto -p -X POST -h current.openphoto.me -e /tag/sunnyvale/update.json -F 'count=10'
 
 <a name="example-php"></a>
+
 #### PHP (using [openphoto-php][openphoto-php])
 
     $client = new OpenPhotoOAuth($host, $consumerKey, $consumerSecret, $oauthToken, $oauthTokenSecret);
@@ -77,6 +82,7 @@ The response is in a standard [response envelope](http://theopenphotoproject.org
       }
     }
 
+--->
 
 [Tag]: http://theopenphotoproject.org/documentation/schemas/Tag
 [purpose]: #purpose

diff --git a/docs/api/Readme.markdown b/docs/api/Readme.markdown
@@ -51,6 +51,8 @@ Every API endpoint returns a JSON response in a [standard envelope](http://theop
     Get a user's tags.
 1.  [POST /tag/create.json](http://theopenphotoproject.org/documentation/api/PostTagCreate)
     Create a tag for the user.
+1.  [POST /tag/:id/delete.json](http://theopenphotoproject.org/documentation/api/PostTagDelete)
+    Delete a tag.
 1.  [POST /tag/:id/update.json](http://theopenphotoproject.org/documentation/api/PostTagUpdate)
     Modify meta data for a user's tag.
 

diff --git a/docs/schemas/Tag.markdown b/docs/schemas/Tag.markdown
@@ -8,9 +8,9 @@ Schema for a Tag object
 
 A Tag object stores information about a specific tag.
 This includes but is not limited to the number of objects containing this tag.
-The Tag objects schema is loose meaning that it can be flexible but at minimum it contains an `id` and `count`.
+The Tag objects schema is loose meaning that it can be flexible but at minimum it contains an `id`, `count`, `actor` and `owner`.
 
-For example, the tag `sunnyvale` can have a `latitude` and `longitude` property.
+There are not currently any optional tag attributes.
 
 ----------------------------------------
 
@@ -19,9 +19,8 @@ For example, the tag `sunnyvale` can have a `latitude` and `longitude` property.
     {
       id: (string),
       count: (int),
-      email: (string),
-      latitude: (float),
-      longitude: (float)
+      actor: (string),
+      owner: (string),
     }
 
 ----------------------------------------
@@ -30,9 +29,8 @@ For example, the tag `sunnyvale` can have a `latitude` and `longitude` property.
 
   * id, Base 36 value of a base 10 auto-incremented value
   * count, The number of objects with this tag
-  * email, Email address if applicable
-  * latitude, Latitude if applicable
-  * longitude, Longitude if applicable
+  * actor, Email address of the tag actor
+  * owner, Email address of the tag owner
 
 [User]: http://theopenphotoproject.org/documentation/schemas/User
 [Photo]: http://theopenphotoproject.org/documentation/schemas/Photo