Views

Register a photo of the building

First of three legs. Returns an upload_policy with a presigned URL; PUT the bytes to it (no Authorization header there, the signature is the authorisation), then confirm. aspect_ratio is optional: given width and height, the server picks the nearest supported ratio itself.

What the file turns out to be is decided on the server once the bytes land: a view of the house that can be designed, a drawing or reference kept with the building, or a refusal with the reason. The answer names it in outcome.

Registering the same file again while its upload is unfinished returns the same upload, so a retry after a dropped connection resumes rather than sending a second copy.

post/projects/{project}/uploads

Request

  • Base URL: https://api.getfacade.ai/api/v1
  • URL: https://api.getfacade.ai/api/v1/projects/{project}/uploads
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.getfacade.ai/oauth/authorize, token URL https://api.getfacade.ai/oauth/token, scopes: agent)

Path parameters

projectstring required

Request body

Example request

{
  "data": {
    "attributes": {
      "content_type": "image/jpeg"
    }
  }
}

Response

Registered

Changes

No recorded changes to this operation across all 1 revision of this API.