List the organization Assets
Lists the active organization’s Assets, newest first. Each row carries its Registrations, so one read answers where every file is and what still needs registering. Reservations whose bytes never arrived are excluded, as are deleted Assets.
/assets/AuthorizationBearer token · headerrequiredSend Authorization: Bearer <credential>. Two credentials work.
An API key (acr_…) is what a server integration uses. Create one in the AdCrunch console under Settings → API keys — see https://docs.adcrunch.dev/account/api-keys. A key is bound to the organization that was active when you created it, and it keeps acting on that organization whatever you do later. It carries the permissions of the member who created it.
A session issued by the AdCrunch sign-in flow also works, which is how the console calls this service from the browser.
Either way the organization comes from the credential. There is no organization parameter.
Every stored Asset in the organization, newest first, each with its Registrations.
objectcontentHashstringrequiredAdCrunch’s own hash of the stored bytes. A hint for de-duplication, never an identity, and never a provider’s hash. Empty when the store reports none.
createdAtnumberrequiredMilliseconds since the Unix epoch, UTC.
createdBystringrequiredThe user who reserved the upload.
deletedAtnumber | nullrequiredAlways null here. A deleted Asset is not answered.
durationMsnumber | nullrequiredHow long the video runs, in milliseconds, where that is known. null for an image.
filenamestringrequiredThe name the file was uploaded under. Never a lookup key.
heightnumber | nullrequiredidstringrequiredkeystringrequiredWhere the bytes are held. Read-only, and never sent by you.
kindstringrequiredRead from the stored bytes at finalize, and never from what you declared. It selects how a provider takes the file.
imagevideomimeTypestringrequiredRead from the stored object at finalize.
namestring | nullrequiredThe name a person gave this Asset, and what a provider receives at a future registration. null until somebody renames it, and the filename is the fallback.
organizationIdstringrequiredsizeBytesnumberrequiredRead from the stored object at finalize.
statusstringrequiredready once the bytes have been inspected. A pending Asset is a reservation whose bytes have not arrived, and no operation here answers one.
pendingreadyupdatedAtnumber | nullrequiredMilliseconds since the Unix epoch, UTC.
widthnumber | nullrequiredregistrationsobject[]requiredEvery advertiser this Asset has been placed with, and how each Registration went. An empty array means it is stored and registered nowhere.
Show propertiesHide properties
objectadvertiserIdstringrequiredThe advertiser whose library holds the bytes.
assetIdstringrequiredcreatedAtnumberrequiredMilliseconds since the Unix epoch, UTC.
deletedAtnumber | nullrequiredSet when a failed attempt was tombstoned to free the pair for a retry. null on a live Registration.
failureReasonstring | nullrequiredThe provider’s own code and message. Only set on a failure.
idstringrequiredorganizationIdstringrequiredproviderstringrequiredThe provider that owns the advertiser.
metagadstiktokxopenaisnapchatdv360providerIdentifierstring | nullrequiredWhat the provider gave back — a Meta image hash or video id. null until the Registration is ready. This is the id a creative is built with.
statusstringrequiredVideo can stay running for several minutes while the provider processes it. That is normal, and not a failure.
runningreadyfailedupdatedAtnumber | nullrequiredMilliseconds since the Unix epoch, UTC.
uploadSessionIdstring | nullrequiredAn in-flight provider upload session, where the protocol has one. null for every image.
workflowIdstringrequiredThe durable execution that placed it.
No credential, or one that does not resolve. Send an API key or a session. See the security scheme. error is unauthorized.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
unauthorizedmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
The caller does not hold asset:read. error is forbidden.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
forbiddenmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.