What authentication does the Phraseanet API use?

The Phraseanet API authentication depends on instance configuration. Most deployments use OAuth 2.0 tokens passed in the Authorization header. Through Jentic, instance-specific credentials are stored in your Jentic One instance and injected at execution time regardless of the authentication method configured on the target instance.

Can I search across multiple collections in a single query?

Yes. The POST /records/search endpoint accepts collection scope parameters that let you search across multiple databoxes simultaneously. Results include the databox ID and record ID for each match, enabling cross-collection asset discovery in a single API call.

How do I upload a new asset with metadata to Phraseanet?

Use POST /records/add with the media file and metadata fields in the request body. You specify the target databox and collection, and Phraseanet creates the record with initial metadata. After upload, use POST /records/{databox_id}/{record_id}/setmetadatas to add or update additional metadata fields.

How do I retrieve asset download URLs through Jentic?

Search Jentic for 'get media download URL from Phraseanet' to find the GET /records/{databox_id}/{record_id}/embed operation. Load the schema, provide the databox ID and record ID, and execute. The response includes URLs for multiple rendition sizes (thumbnail, preview, original) ready for download or embedding.

Can I limit what my agent is allowed to do with the Phraseanet API?

Yes. Jentic One is self-hosted by you, so your own rules decide which Phraseanet operations and credentials the agent may use. Because Phraseanet puts the databox and record IDs in the URL path (/records/{databox_id}/{record_id}), a rule can pin the agent to a single record and let it read only that record, its caption, and its embed. You choose the operations it may call, so writes such as POST /records/{databox_id}/{record_id}/setmetadatas or POST /records/add stay off limits unless you add them.