Add photo
POST
/jobs/{id}/photos
const url = 'https://example.com/jobs/example/photos';const options = { method: 'POST', headers: { 'Idempotency-Key': '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0', 'Content-Type': 'application/json' }, body: '{"fileId":"example","caption":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/jobs/example/photos \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \ --data '{ "fileId": "example", "caption": "example" }'Who can call it: Owners, Staff and Field users. Staff need the Team right Add own job photos (job_photos.edit_own).
curl -X POST "https://spine.example.com/api/jobs/<id>/photos" \
-H "Cookie: better-auth.session_token=<session>" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" -d '{ … }'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Header Parameters
Section titled “Header Parameters”Idempotency-Key
required
string format: uuid
A fresh UUID per action. A retry with the same key gets the first answer instead of doing it twice.
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
fileId
required
File id already uploaded via POST /files.
string
caption
string
Example generated
{ "fileId": "example", "caption": "example"}Responses
Section titled “Responses”Validation failed or a business rule was broken; message says what to change.
No session, or it has expired: sign in again.
The caller’s role, Team rights or ownership don’t allow it, the module is switched off, or their access was removed.
No such record in this business.
The same Idempotency-Key is still being handled, or the record conflicts with one that exists.
Too many requests: wait a minute.
Something went wrong on the server; the response carries the request id to report.