Add a person to a photo. Coordinates and sizes of boxes are optional; they are measured in pixels, based on the 500px image size shown on individual photo pages.
This method requires authentication with 'write' permission.
Note: This method requires an HTTP POST request.
- Your API application key. See here for more details.
- The id of the photo to add a person to.
- The NSID of the user to add to the photo.
- The left-most pixel co-ordinate of the box around the person.
- The top-most pixel co-ordinate of the box around the person.
- The width (in pixels) of the box around the person.
- The height (in pixels) of the box around the person.
This method has no specific response - It returns an empty success response if it completes without error.
1: Person not found
- The NSID passed was not a valid user id.
2: Photo not found
- The photo id passed was not a valid photo id.
3: User cannot add this person to photos
- The person being added to the photo does not allow the calling user to add them.
4: User cannot add people to that photo
- The owner of the photo doesn't allow the calling user to add people to their photos.
5: Person can't be tagged in that photo
- The person being added to the photo does not want to be identified in this photo.
6: Some co-ordinate paramters were blank
- Not all of the co-ordinate parameters (person_x, person_y, person_w, person_h) were passed with valid values.
7: Can't add that person to a non-public photo
- You can only add yourself to another member's non-public photos.
8: Too many people in that photo
- The maximum number of people has already been added to the photo.
96: Invalid signature
- The passed signature was invalid.
97: Missing signature
- The call required signing but no signature was sent.
98: Login failed / Invalid auth token
- The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions
- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100: Invalid API Key
- The API key passed was not valid or has expired.
105: Service currently unavailable
- The requested service is temporarily unavailable.
106: Write operation failed
- The requested operation failed due to a temporary issue.
111: Format "xxx" not found
- The requested response format was not found.
112: Method "xxx" not found
- The requested method was not found.
114: Invalid SOAP envelope
- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
- The XML-RPC request document could not be parsed.
116: Bad URL found
- One or more arguments contained a URL that has been used for abuse on Flickr.