Skip to content
FacilydevelopersDashboard
Build with Facily
DocsREST APIsList Task Photos
Search the full API reference Esc to close

List Task Photos

Tasks · REST API reference

Get support
GET/v1/tasks/{task_id}/photos
Every confirmed photo of a task, oldest first, each with a link valid for 15 minutes.

Authentication

Bearer API key or Facily session, subject to permissions and facility scope.

Authentication and scope

Request example

Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.

cURL
curl --request GET \
  --url 'https://api.staging.facily.ai/v1/tasks/<TASK_ID>/photos' \
  --header "Authorization: Bearer $FACILY_API_KEY"
An example for building your request, not an executed call. Check required fields, allowed values, and environment configuration before sending.

Try a request

Staging · read-only

Explore your organization with a read-only request to staging.

Kept in this tab only. Sent directly to api.staging.facily.ai.

GET

Replace the {placeholders} in the path with your resource IDs.

Response
Your response will appear here.

Parameters

task_idpath · stringrequired

Format: uuid

Responses

Expand a status to inspect its schema. Generated examples show structure and synthetic values.

200Successful Response
JSON · generated example
{
  "data": [
    {
      "can_delete": false,
      "document_type": "string",
      "expires_at": "2026-10-29T12:00:00Z",
      "file_size_bytes": 0,
      "id": "00000000-0000-4000-8000-000000000001",
      "mime_type": "string",
      "title": "string",
      "unit_id": "00000000-0000-4000-8000-000000000001",
      "uploaded_at": "2026-10-29T12:00:00Z",
      "uploaded_by": {
        "display_name": "string",
        "id": "00000000-0000-4000-8000-000000000001"
      },
      "url": "string"
    }
  ],
  "meta": {
    "request_id": "string"
  }
}

application/json

dataTaskPhotoResponse[]required
Show data schema
can_deletebooleanrequired

True when the caller may remove this photo now.

document_typestringrequired

The photo's type: task_photo_proof, task_photo_reference, task_photo_before, task_photo_after or task_photo_finding.

expires_atstringrequired

When url stops working.

Format: date-time

file_size_bytesintegerrequired

The file's size in bytes, as stored.

idstringrequired

The photo's id.

Format: uuid

mime_typestringrequired

The file's type: image/jpeg, image/png or image/webp.

titlestring | nullrequired

The photo's label, such as its file name; null when none was sent.

Show title schema
string | null

The photo's label, such as its file name; null when none was sent.

Variant 1: string
string
Variant 2: null
null
unit_idstring | nullrequired

The unit of the inspection finding this photo belongs to; null for every other photo, and for a finding photo whose unit is gone.

Format: uuid

Show unit_id schema
string | null

The unit of the inspection finding this photo belongs to; null for every other photo, and for a finding photo whose unit is gone.

Variant 1: string
string
Variant 2: null
null
uploaded_atstringrequired

When the upload was confirmed.

Format: date-time

uploaded_byPersonResponserequired

A user, as a task or a thread entry names one.

Show uploaded_by schema
display_namestringrequired

The name to show for the user.

idstringrequired

The user's id.

Format: uuid

urlstringrequired

A link to the file, valid for 15 minutes. Opened in a browser tab, it downloads the file.

metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
400Validation error
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
401Unauthenticated
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
403Permission denied
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
404Not found
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
409Business logic error
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
503Temporary failure
JSON · generated example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  },
  "meta": {
    "request_id": "string"
  }
}

application/json

errorErrorBodyrequired

The shape of error.* in an error response.

Show error schema
codestringrequired
detailsobject | null
Show details schema
object | null
Variant 1: object
object
Variant 2: null
null
messagestringrequired
metaMetarequired

Envelope metadata. Every response carries one.

Show meta schema
request_idstringrequired
Continue exploringAll tasks operations
Build something that works beautifully.

Facily API · Contract v1.200 · Reviewed October 29, 2026

List Task Photos | Facily Developers