Mettre à jour un dossier avec l'API Vimeo
Renomme un dossier de l'utilisateur connecté et le renvoie.
- Identifiant
- vimeo_update_folder
L'appel
POST https://connect.reportei.com/api/tools/vimeo_update_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": 1,
"name": "<name>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| project_id | integer | Oui | Id of the folder: the number at the end of its uri in List folders. |
| name | string | Oui | New name of the folder. |
Connexions possibles
Votre client connecte son compte Vimeo une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/vimeo, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/vimeo_update_folder. Il devient la définition de tool de votre agent sans conversion.
Autres tools Vimeo
- Lister les vidéosGETListe les vidéos téléversées par l'utilisateur connecté, avec uri, name, description, link, duration, privacy, parent_folder, tags, code d'embed et stats.plays, le nombre de lectures.
- Obtenir une vidéoGETRenvoie une vidéo : name, description, link, duration, dimensions, privacy, status, parent_folder, tags, code d'embed, miniatures et stats.plays, le nombre de lectures.
- Mettre à jour une vidéoPATCHMet à jour le titre, la description, la confidentialité ou la licence d'une vidéo de l'utilisateur connecté et la renvoie. Les champs omis gardent leur valeur.
- Lister les dossiersGETListe les dossiers de l'utilisateur connecté, avec uri, name, link, dates et le nombre de vidéos dans metadata.connections.videos.total.
- Créer un dossierPOSTCrée un dossier pour l'utilisateur connecté et le renvoie avec son uri. Sans parent_folder_uri c'est un dossier de premier niveau ; les dossiers s'imbriquent jusqu'à 10 niveaux.
- Lister les vidéos d'un dossierGETListe les vidéos d'un dossier, avec uri, name, description, link, duration, privacy, tags et stats.plays, le nombre de lectures. Pagination par page.
- Déplacer une vidéo dans un dossierPUTPlace une vidéo dans un dossier de l'utilisateur connecté, qui doit en être le propriétaire. Répond 204 sans corps quand cela fonctionne.
- Lister les commentaires d'une vidéoGETListe les commentaires d'une vidéo, avec uri, text, author, date et le nombre de réponses dans metadata.connections.replies.total.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
