List imports
Alpha
The contract may change without notice, and imports created with it are not guaranteed to remain compatible. Not covered by the deprecation policy.
Sample request
curl -X GET "https://api.abyssale.com/designs/import/json" \
-H "x-api-key: $ABYSSALE_API_KEY"Example 200 response
[
{
"id": "64238d01-d402-474b-8c2d-fbc957e9d290",
"name": "Autumn card",
"status": "WAITING_FOR_VALIDATION",
"created_at_ts": 1649942114,
"validated_at_ts": 1649942200,
"warning_count": 3,
"links": {
"validate": "https://api.abyssale.com/designs/import/json/64238d01-d402-474b-8c2d-fbc957e9d290",
"status": "https://api.abyssale.com/designs/import/json/64238d01-d402-474b-8c2d-fbc957e9d290",
"dashboard": "https://app.abyssale.com/designs/9c2f31a0-8810-4c4b-bbf5-44a02e1f1d2f"
},
"result": {
"kind": "workspace_template",
"uuid": "00000000-0000-0000-0000-000000000000",
"project_uuid": "00000000-0000-0000-0000-000000000000"
}
}
]Example 400 error response
{
"id": "out_of_range",
"message": "formats[0].width: Must be greater than or equal to 1 and less than or equal to 5000.",
"errors": [
{
"path": "formats[0].width",
"code": "out_of_range",
"message": "Must be greater than or equal to 1 and less than or equal to 5000.",
"expected": {
"min": 1,
"max": 5000
},
"received": 99999999
}
]
}List this company's JSON template imports, newest first.
Behaviour, limits and caveats
Use this to recover an import whose id you no longer have. Because the flow is POST → upload → PUT, a client that loses the id between those steps leaves behind an import it cannot otherwise resume or inspect; listing is how you find it again.
Rows are summaries. The unbounded warnings[] array and the error object are served by GET /designs/import/json/{importId} — a row carries warning_count instead, and a links.status pointing at that endpoint.
status filters on the effective status, matching what the item endpoint reports: an import whose presigned upload window has closed counts as FAILED, not WAITING_FOR_VALIDATION.
Lists JSON imports exclusively — imports created through other channels are not returned.
No cursor. Results are capped by limit; narrow with created_after / created_before to reach imports beyond the cap.
Query parameters
status string
Return only imports whose effective status matches. One of "WAITING_FOR_VALIDATION", "QUEUED", "PROCESSING", "DONE", "FAILED".
created_after integer
Unix timestamp (seconds). Return imports created at or after this moment.
created_before integer
Unix timestamp (seconds). Return imports created at or before this moment.
limit integer
Maximum number of imports to return. Defaults to 50. Range 1–200.
Response 200
The matching imports, newest first.
Errors
Every failure uses the shared error envelope — {id, message, errors?}. Branch on id, never on message. See Errors.
| Status | When |
|---|---|
400 | A query parameter is invalid — invalid_query_param for limit / created_after / created_before, unknown_enum_value for an unrecognised status. |
401 | Unauthorized — missing or invalid API key. |
429 | Too Many Requests. |
500 | Internal Server Error — an unexpected error occurred on our side. |