Imports an external image, video, or audio URL into the team asset library (e.g. before starting a process). Pass sessionId to create it inside a session, and libraryFolderId to file it into a Library folder. Importing an image the team already imported (identical file) returns that existing asset, with its original name, instead of a copy; with sessionId it is added to the session. Spends no credits. Download failures return 400 with code import_failed.
Authorization
bearerAuth assets:writeIn: header
Scope: assets:write
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/assets/import" \ -H "Content-Type: application/json" \ -d '{ "type": "image", "url": "http://example.com" }'{ "id": "string", "type": "image", "name": "string", "url": "http://example.com", "thumbnailUrl": "http://example.com", "preview": { "url": "http://example.com", "width": 0, "height": 0, "mimeType": "string" }, "width": 0, "height": 0, "duration": 0, "mimeType": "string", "source": "string", "sourceProcessId": "string", "prompt": "string", "model": "string", "trainingId": "string", "draft": { "finishableUntil": "2019-08-24T14:15:22Z", "finishResolutions": [ 1080 ] }, "favorite": true, "sessionId": "string", "libraryFolderIds": [ "string" ], "createdBy": "string", "metadata": { "property1": "string", "property2": "string" }, "testMode": true, "webUrl": "http://example.com", "createdAt": "2019-08-24T14:15:22Z", "links": { "self": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}Get a workspace page link GET
A web app link to give the user for a page outside any session: view=elements (the element library; with element, an id or @ID like @hero or @hero:coat-on, that element opens on that image) or view=library (the asset library; with libraryFolderId, filtered to that Library folder). Session pages are GET /sessions/{sessionId}/links. Naming an element or a Library folder needs assets:read.
Invite someone to a project by email POST
Adds an existing workspace member directly, preserving their workspace role. A new person is invited as a project-only guest by default. Only workspace owners and admins can invite guest editors. Workspace roles and seat limits still apply.