PUT /notes/:id

Description Edit a note.
Method & URL
PUT https://api.findery.com/v2/notes/:id
Scope notes
Required. This is the authentication token for the user that is creating the note.
At least one of title or message is required. This is the title of the note. If no title is added, one will be created based on the 'message' contents.
At least one of title or message is required. This is the main text of the note.
Required. One of self, recipients, or public. If recipients, an additional parameter called recipients with an array of user IDs is expected.
Required. Location is a hash with the required fields latitude and longitude with both in decimal degrees. In addition, location may accept an optional human-readable address (e.g., "1600 Pennsylvania Avenue, Washington, D.C., United States") and optional zoom_level that corresponds to Google Maps API zoom level and may be used in note presentation in certain contexts. Finally, a note may also be added to a place in one of two ways:
  • To create a new brand new place (e.g., "my favorite couch"), simply add name field to the location hash.
  • To add a note to an existing place (e.g. "Golden Gate Bridge"), instead include an id field with the place's ID as its value.
Optional. This takes an array of strings, where each string is the tag name.
Optional. This is the content of the image file to upload. We support any JPEGs, PNGs, and GIFs up to 20 MBs.
Example Request
curl -X PUT -H "Authorization: Bearer ACCESS_TOKEN" -F 'title=this is a updated title' https://api.findery.com/v2/notes/932009001403
Example Response
    "data": {
        "author": {
            "avatar": {
                "hasAvatar": false,
                "hash": "5d67a569d76e810d2d9755451601322a",
                "urlRoot": "https://s3-us-west-1.amazonaws.com/avatars1.dev.findery.com/default/"
            "id": 257699140080,
            "link": "https://findery.com/MRMAN",
            "name": null,
            "username": "MRMAN"
        "comments": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/comments"
        "createdAt": 1415156288,
        "currentUserData": {
            "canComment": true,
            "canFavorite": true,
            "isFavorited": false,
            "isFound": false,
            "isUnfound": false
        "depiction": null,
        "displayAddress": null,
        "favoriters": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/favoriters"
        "finders": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/finders"
        "id": 932009001403,
        "link": "https://findery.com/MRMAN/notes/testmessage234234-5",
        "location": {
            "city": "Coulterville",
            "country": "United States",
            "isoCountryCode": "US",
            "latitude": 37.7,
            "longitude": -120.1,
            "neighborhood": null,
            "postalCode": "95311",
            "state": "California",
            "street": "Ponderosa Way",
            "streetAddress": "Stanislaus National Forest, 9416 Ponderosa Way, Coulterville, CA 95311, USA",
            "streetNumber": "9416",
            "zoomLevel": 13
        "message": null,
        "notemaps": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/notemaps"
        "publicViewsCount": 0,
        "tags": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/tags"
        "title": "This is an updated title",
        "updatedAt": 1415157331,
        "visibility": "public"
    "meta": {
        "http_status": 200