API Documentation

Feeling RESTful?

API v2 » faces/delete (POST w/ OAuth Echo)

Currently, for privacy reasons, users can only delete face tags on photos they've uploaded.

Description

This method deletes a face tag from a photo. BETA

URL

http://api.twitpic.com/2/faces/delete

Available Formats

xml, json

HTTP Method

POST

Requires Authentication

True

Header Example

	
	OAuth realm="http://api.twitter.com/", 
	oauth_consumer_key="GDdmIQH6jhtmLUypg82g", 
	oauth_signature_method="HMAC-SHA1", 
	oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", 
	oauth_timestamp="1272325550", 
	oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", 
	oauth_version="1.0", 
	oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"

X-Auth-Service-Provider (Required)

https://api.twitter.com/1/account/verify_credentials.json

Parameters

key (Required): The API key of the calling application/website
tag_id (Required): The unique ID of the facetag (can be retrieved from faces/show)

Responses

If HTTP status 200 is returned, you can assume the face tag was deleted.

Example CURL Command

	curl -v -H 'X-Auth-Service-Provider: https://api.twitter.com/1/account/verify_credentials.json' -H 'X-Verify-Credentials-Authorization: OAuth realm="http://api.twitter.com/", oauth_consumer_key="GDdmIQH6jhtmLUypg82g", oauth_signature_method="HMAC-SHA1", oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", oauth_timestamp="1272325550", oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", oauth_version="1.0", oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"' -F "key=098f6bcd4621d373cade4e832627b4f6" -F "key=my_app_key" -F "tag_id=155979" http://api.twitpic.com/2/faces/delete