Skip to content
Documentation/Documents

Register retained source bytes

Register immutable original bytes for an uploaded asset owned by the caller.

Markdown
POST/api/v2/sourceshttps://api.webcite.co

When to use it

Send multipart/form-data with assetId and file. The asset must already belong to your account. If upload_file already returned source_version_id, use that retained ID directly.

Request

No fixed public credit price is specified for this V2 operation.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --fail-with-body -X POST 'https://api.webcite.co/api/v2/sources' \
  -H "x-api-key: $WEBCITE_API_KEY"

No request body is required.

Response

Returns sourceVersionId, assetId, bytesHash, and source metadata. Keep the version ID for representation publication.

201 response

See the response guidance above. A complete JSON schema is not published for this response.

Errors

A missing file or foreign asset is rejected. Source bytes and asset ownership are checked before publication.

Error handling and retry guidance