Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shootbin.com/llms.txt

Use this file to discover all available pages before exploring further.

Annotations are comments pinned to a precise location on a photo. Instead of writing “fix the hair on the left” in a general message, you click the exact spot on the image and type your note there. Both photographers and clients (approvers) can add annotations, reply to each other’s notes in threaded comments, and mark notes as resolved once the feedback has been addressed.

​
Adding an annotation

1

Enter annotation mode

Open a photo and click the Add Note button (or press Ctrl+N / Cmd+N). The cursor changes to a crosshair to indicate you are in annotation mode.
2

Place your marker

Click anywhere on the photo to drop a marker at that position. For rectangular area annotations, switch to rectangle mode and drag to draw a box over the area you want to highlight.
3

Type your comment

A text input appears next to your marker. Type your feedback and press Save (or hit Enter) to post the annotation.
4

Exit annotation mode

Click Done or press Ctrl+N / Cmd+N again to leave annotation mode. Your notes are saved and visible to everyone with access to the photo.
Annotations are pinned using percentage-based x/y coordinates relative to the photo, so they stay in the correct position regardless of screen size or zoom level.

​
Who can annotate

Photographers (owners)

Owners can add annotations, edit their own notes, move markers by dragging them in annotation mode, and delete any annotation on the photo.

Clients (approvers)

Approvers can add annotations and reply to existing annotation threads. They cannot delete notes left by other users.
Guest users can view photos and their annotations but cannot add or edit notes.

​
Annotation threads

Each annotation supports a reply thread, so conversations about a specific spot stay organized in one place.
  • Click on any annotation marker to open the thread panel.
  • Type in the reply box at the bottom of the thread and press Send to post a reply.
  • You can delete your own comments from a thread; owners can delete any comment.

​
Resolving annotations

Once you have addressed a piece of feedback, mark the annotation as resolved to keep the list tidy.
1

Resolve a single annotation

Open an annotation and click Resolve. The marker turns grey and moves to the “Resolved” filter view. Click Unresolve to reopen it if needed.
2

Resolve all open annotations at once

When you have addressed all outstanding feedback, click Resolve All at the top of the annotations panel. This marks every open annotation on the photo as resolved in one action.
You can filter the annotation list by All, Open, or Resolved to focus on what still needs attention.
Resolve annotations as you upload revised photos. A clean resolved list makes it easy to confirm at a glance that all feedback was addressed before you request the next review round.

​
API

You can manage annotations programmatically using the Shootbin API. All requests require a Bearer token and Accept: application/json.

​
Add an annotation

POST /api/projects/{project}/albums/{album}/photos/{photo}/annotations
Request body: 
{
  "comment": "Please retouch the background near the top-left corner.",
  "x_position": 12.5,
  "y_position": 8.3
}
FieldTypeDescription
commentstringThe annotation text. Required.
x_positionfloatHorizontal position as a percentage (0–100) of the photo width.
y_positionfloatVertical position as a percentage (0–100) of the photo height.
Example: 
curl -X POST https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/annotations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Soften the shadow on the left cheek.","x_position":42.5,"y_position":31.2}'

​
Delete an annotation

DELETE /api/projects/{project}/albums/{album}/photos/{photo}/annotations/{annotation}

curl -X DELETE https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID/annotations/ANNOTATION_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Deleting an annotation also removes its entire reply thread. This action cannot be undone.