Import image from URL

Synchronously fetches an image from a public URL and ingests it as an UploadedImage asset.

Authorization

token_auth

AuthorizationBearer <token>

Token-based authentication using access tokens.

In: header

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*Url

Public HTTP/HTTPS URL of the image to import.

Length1 <= length <= 2048

filename?|

Optional filename override for the imported asset.

Defaultnull

project_id?|

Optional project ID to associate the asset with.

Defaultnull

tag_ids?array<string>

IDs of existing, visible tags to assign to the newly created asset.

Default[]

new_tags?array<>

New tags to create (owned by the caller) and assign to the newly created asset.

Default[]

curl -X POST "https://v2.api.piktid.com/upload/from-url" \  -H "Content-Type: application/json" \  -d '{    "url": "string"  }'

{
  "asset_id": "string",
  "filename": "string",
  "url": "string",
  "project_id": null,
  "tags": []
}

{
  "error": "Invalid request",
  "detail": [
    {
      "field": null,
      "message": "string",
      "position": "query"
    }
  ]
}

Empty