# Intake Upload

## GET /upload/{link\_token}/info

> Get Link Info

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"LinkInfoResponse":{"properties":{"display_name":{"type":"string","maxLength":512,"title":"Display Name","description":"Human-readable display name (falls back to customer slug)."},"customer_slug":{"type":"string","maxLength":128,"title":"Customer Slug","description":"Stable URL-safe customer identifier."},"max_upload_bytes":{"type":"integer","minimum":0,"title":"Max Upload Bytes","description":"Maximum allowed upload size in bytes."},"allowed_content_types":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Allowed Content Types","description":"Allowed Content-Type values for uploads, sorted lexicographically."}},"type":"object","required":["display_name","customer_slug","max_upload_bytes"],"title":"LinkInfoResponse","description":"Public metadata for an intake upload link, returned to the forms app."},"LinkErrorResponse":{"properties":{"error_code":{"type":"string","enum":["invalid_token","link_not_found","link_expired","link_exhausted"],"title":"Error Code","description":"Machine-readable error code."},"message":{"type":"string","maxLength":512,"title":"Message","description":"Human-readable error message."}},"type":"object","required":["error_code","message"],"title":"LinkErrorResponse","description":"Error envelope returned for token / link validation failures."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/upload/{link_token}/info":{"get":{"tags":["Intake Upload"],"summary":"Get Link Info","operationId":"get-intake-link-info","parameters":[{"name":"link_token","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Link Token"}}],"responses":{"200":{"description":"Link metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkInfoResponse"}}}},"400":{"description":"Invalid token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkErrorResponse"}}}},"404":{"description":"Link not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkErrorResponse"}}}},"410":{"description":"Link expired or exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Rate limited"}}}}}}
```

## POST /upload/{link\_token}/files

> Receive Upload

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"UploadFileResponse":{"properties":{"id":{"type":"string","maxLength":64,"title":"Id","description":"UUID of the newly created upload row."},"filename":{"type":"string","maxLength":256,"title":"Filename","description":"Stored filename."},"sha256":{"type":"string","maxLength":128,"title":"Sha256","description":"SHA-256 of the uploaded bytes (lowercase hex)."},"size_bytes":{"type":"integer","minimum":0,"title":"Size Bytes","description":"Stored size in bytes."},"scan_status":{"type":"string","maxLength":32,"title":"Scan Status","description":"Virus-scan status (e.g. ``clean``, ``skipped``)."},"duplicate_of":{"anyOf":[{"$ref":"#/components/schemas/UploadDuplicateInfo"},{"type":"null"}],"description":"Set when this upload's content hash matched a prior upload; otherwise null."}},"type":"object","required":["id","filename","sha256","size_bytes","scan_status"],"title":"UploadFileResponse","description":"Receipt for a successful upload via an intake link."},"UploadDuplicateInfo":{"properties":{"id":{"type":"string","maxLength":64,"title":"Id","description":"UUID of the existing upload row."},"received_at":{"type":"string","maxLength":64,"title":"Received At","description":"ISO-8601 timestamp the original upload was received."}},"type":"object","required":["id","received_at"],"title":"UploadDuplicateInfo","description":"Pointer to an existing upload row when content-hash dedup fires."}}},"paths":{"/upload/{link_token}/files":{"post":{"tags":["Intake Upload"],"summary":"Receive Upload","operationId":"upload-intake-file-via-link","parameters":[{"name":"link_token","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Link Token"}},{"name":"x-amigo-intake-filename","in":"header","required":true,"schema":{"type":"string","maxLength":256,"title":"X-Amigo-Intake-Filename"}},{"name":"x-amigo-intake-content-type","in":"header","required":true,"schema":{"type":"string","maxLength":128,"title":"X-Amigo-Intake-Content-Type"}}],"responses":{"201":{"description":"File uploaded successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadFileResponse"}}}},"404":{"description":"Link not found"},"410":{"description":"Link expired"},"413":{"description":"File too large"},"422":{"description":"Invalid filename or content type"},"429":{"description":"Rate limited or upload limit reached"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.amigo.ai/api-reference/readme/platform/intake-upload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.